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Preface 


Obectives 


This manual describes directives to the RSTS/E monitor, the RSX 
emulator, and the RT11 emulator that you can use in MACRO programs. 

To use these directives, you should be familiar with the MACRO-11 
assembly language. MACRO is the standard assembler for DIGITAL PDP-11 
computers and is available under various operating systems for the 
PDP-ll. Note that the syntax is basically the same for all operating 
systems. 


Manual Structure 


This manual contains seven chapters and two appendixes: 


Chapter 1 Gives an overview of run-time systems and jobs as they 
relate to the system directives. 


Chapter 2 Describes the RSTS/E environment (memory allocation and 
job space) for the general monitor directives. 


Chapter 3 Contains reference material for the general monitor 
directives that you can use in programs compiled under 
either the RSX or RT11 run-time systems. 


Chapter 4 Describes the RSX environment for the RSX directives. 


Chapter 5 Contains reference material for the directives processed 
by the RSX emulator or the RSX run-time system. 


Chapter 6 Describes the RT11 environment for the RTl1l directives. 


Chapter 7 Contains reference material for the directives processed 
by the RT11 emulator in the RT11l run-time system. 


Appendix A Lists the RSTS/E errors you can get during directive 
processing. 


Appendix B Summarizes MODE and RECORD values and other useful 
information for disks, flexible diskettes, magnetic 
tape, line printers, terminals, and pseudo keyboards. 

Related Documents 
For information about the syntax of MACRO assembly language, see the 


PDP-11 MACRO-1ll Language Reference Manual. 


Xi 


Where appropriate, this manual references the following manuals from 
the RSTS/E documentation set: 


RSTS/E System Installation and Update Guide 


RSTS/E System Manager’s Guide 


RSTS/E System User’s Guide 


BASIC-PLUS Language Manual 


RSTS/E Programming Manual 


RSTS/E Programmer’s Utilities Manual 


RSTS/E Task Builder Reference Manual 


Conventions 


This manual uses the following conventions: 


—> 


{} 


<> 


The arrow means points to, or contains the address of, as when 
the stack pointer register points to the first item in the 
stack. For example: 


SP— >» item at top of stack 
item one word down from top of stack 


Parentheses mean the contents of the item that the parentheses 
surround. For example, the contents of the program counter 
would be represented as: 


(PC) 


Brackets around an item indicate that the item is optional. 
For example: 


QIOS paraml [,param2] 


Braces around two or more items indicate that you must choose 
one of the enclosed items. For example: 


QIOS 
QIOWS 


Angle brackets around two or more items tell the MACRO 
assembler that the items make up a list. For example: 


GLOBAL<namel[,name2,...]> 


Xil 


Summary of Technical Changes 


The functions of several RSTS/E monitor directives have been expanded 
for v9.0, and some new directives have been added. The following is a 
summary: 


-AST 
A new directive to enable or disable asynchronous AST deliveries 
from the user program. 


-ASTX 
A new directive to return control to the calling program when an 
asynchronous routine completes its operation. 


. CMDLN 
A new directive to let you pass up to 1K words of data when 
chaining. 


- CORE 
Quotas and I&D space. 


-MESAG (Message Send/Receive) 
A new subfunction (-11) of .MESAG, sends privilege data. A new 
qualifier, "conditional remove" was added to the Remove Receiver 
subfunction. 


- READA 
A new directive, performs asynchronous read and/or read-check 
operations. 


-SPEC (line printers) 
New .SPEC functions return the current value of a 32-bit page 
counter, or the current vertical and horizontal line position. 


-SPEC (magnetic tape) 
New .SPEC functions return end-of-volume (EOV) and error condition 
acknowledge (ECA) data. 


UU.CFG (Change system characteristics) 
A new directive, lets you change the system default characteristics 
if you have the necessary privileges. 


UU.CHK (Check access function) 
A new directive, performs privilege checking functions. 


UU.LOK 
A new subfunction, lets you look up marked-for-delete files. 


UU.ONX (Open next file) 
A new directive, performs an open next disk file on an I/O channel. 
The file specification can be for a single file or a series of 
files. 


be Mer 


UU.PRV (Set/clear/read current privileges) 


A new directive to let you read the current privilege mask. You 
can also selectively set or clear bits in the current privilege 
mask. 

UU.RTS 


A new subfunction to let you create dynamic regions in memory. 


UU.TBl (Get Monitor Tables - Part 1) 
Some of the monitor tables have been expanded. 


UU.TB3 (Get Monitor Tables - Part 3) 
Some of the monitor tables have been expanded. 


UU.TRM 
Calls to UU.TRM have been extended for new features. 


UU.3PP (Third-party privilege check) 
A new directive, enables or disables third-party privilege 
checking. 


~WRITE 
A new error condition, end-of-file (EOF), was added for an attempt 
to write beyond the end of the disk when the disk was opened 
non-file-structured. Also, additional reasons for getting a PRVIOL 
error condition have been documented. 


-WRITA 
A new directive, performs asynchronous write operations. 


Five new RSX emulation directives were added: 


CRRG$ 
Creates a dynamic region and optionally attaches to it. 


RDBBKS 

RDBDFS 
Two new directives for use with resident library definition blocks 
(RDBs). 


WDBBKS 


WDBDFS 
Two new directives for use with window definition blocks (WDBs). 
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Chapter ls: Introduction 


There are two MACRO assemblers available for the run-time systems on 
RSTS/E: one for RSX and one for RT1l1l. You will use one of these two 
run-time systems to assemble and, in most cases, run your programs. 
In addition to user programs, you can also write or modify run-time 
systems that run under direct control of the RSTS/E monitor. 


This manual describes the three types of system directives available 
to RSTS/E assembly language programmers: 


o General monitor directives 
o RSX emulator directives 
o RT1l1 emulator directives 


Before you start using these directives, it is helpful to understand 
some basic concepts about RSTS/E run-time systems and jobs. 


Run-Time Systems 


A run-time system lets you write code that can be shared by many users 
when it is in memory. In a time-sharing system such as RSTS/E, 
shareable code is an important consideration. 


Run-time systems are normally written as pure code. This means they 
have only instructions and fixed data, and contain no variable data. 
Such code saves space, since many jobs can use it. It also saves time 
since run-time systems are not swapped in and out of memory like user 
programs. Because the run-time systems contain no variable data, they 
do not need to be swapped out to disk; they are simply reloaded when 
they are needed again. 


RSTS/E always has at least one permanently resident run-time system. 
It is called the primary run-time system, because it is the first (and 
only) run-time system at system start-up. RSTS/E loads other run-time 
systems when programs request them, and they remain in memory only as 
long as necessary. 


User Environment 


The DCL, BASIC-PLUS, RSX, and RT1ll run-time systems all have a 
keyboard monitor. That is, they can accept, analyze, and act on 
commands you type at a terminal keyboard. The RSTS/E System User’s 
Guide gives an overview of the user environment these run-time systems 
provide. 


1-1 


Introduction 


Program Environment 


Run-time systems also provide an environment for programs. MACRO 
programmers are concerned with the program environment provided by the 
RT11 run-time system. This run-time system includes: 


o A loader. This code loads a program from disk into memory 
and starts its execution. 


o An emulator. This code emulates directives handled by 
DIGITAL’s RT-11 operating system for the PDP-11 computer. 


Note 


The RSX run-time system only provides a user 
(command) environment. Both the program loader and 
the emulation functions for the RSX environment are 
built into the RSTS/E V9.0 monitor. 


A run-time system usually takes up space in the 32K-word area called 
the user job area. Therefore, a run-time system limits the size of 
your program to less than 32K words. The RT1l1l run-time system takes 
4K words of virtual memory. The RSX run-time system is in the 
monitor. Chapter 2 explains space requirements in greater detail. 


Should you program under the RSX or RT11l run-time system? RSX is 
usually a better choice because it is in the monitor and it offers 
easy access to most resident libraries. Your decision depends on: 


Oo Whether you are coding MACRO subroutines for use ina 
high-level language program 


o Which set of program development tools better satisfies your 
needs 


o Whether you want to use resident libraries 


o Whether you need separate instruction and data space (Ié&D 
Space) support for programs larger than 32K words 


High-Level Languages 


When you write MACRO subroutines for use in high-level language 
programs, the high-level language dictates which run-time system you 
must use. BASIC-PLUS-2, COBOL-81, PDP-11 COBOL, DIBOL, and FORTRAN-77 
all run under the RSX emulator, while FORTRAN-IV runs under the RT1l 
run-time system. You must compile, link, and run all the modules in 
your program under the same run-time system, whether your program is 
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written in MACRO or in a high-level language. 


Program Development Tools 
As Table 1-1 shows, RSTS/E provides one set of program development 


tools for the RSX environment and another set for the RT1ll 
environment. 


Table 1-1: RSX and RT11 Development Tools 


Hert ee ee ee eee eee +e - eee eee tere eee eee + 
| Tool | RSX | RT1ll1_ | 
tern eee ee eee eee teen eee eee torte ee eee + 
| | | 
| Assembler | MAC | MACRO | 
| | | | 
| Linker | TKB | LINK | 
| | | | 
| Librarian | LBR | LIBR | 
| | | | 
| Patch Utility | PAT | PAT | 
tere eee ee ee ee eee tee eee eee tose eee eee + 


While the tools for each environment perform similar functions, they 
differ in their speed and capabilities: 


o Assemblers -- RSTS/E supports two MACRO-11 assemblers, the 
RSX-based MAC assembler and the RT1ll-based MACRO assembler. 
The two assemblers are nearly identical in function and 
performance and produce similar output. 


o Linkers -- RSTS/E supports two linkers: the Task Builder 
(TKB) for RSX-based programs and LINK for RT1ll-based 
programs. While LINK is faster than the Task Builder, the 
Task Builder is more powerful. It can link much larger and 
more complex overlay structures (including co-trees) than 
LINK. Unlike LINK, the Task Builder has options for linking 
to resident libraries and support for separation of 
instructions and data. 


o Librarians -- RSTS/E provides LBR for RSX-based programs and 
LIBR for RT1ll-based programs. You can create object and 
macro libraries with either utility. LBR also lets you 
create universal libraries, which can contain any type of 
file, including text files. 


o Object module patch utilities -- RSTS/E provides a PAT 
utility for each environment. Both let you update code in a 
relocatable binary object module. 
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For details on these program development tools, see the: 


o RSTS/E Task Builder Reference Manual -- Describes the Task 
Builder 

Oo RSTS/E Programmer’s Utilities Manual -- Describes the 
RSX-based MACRO assembler, librarian, and object module patch 
utilities 

© RSTS/E RT1l Utilities Manual -- Describes the RTll-based 
MACRO assembler, librarian, linker, and object module patch 
utilities 

© PDP-11 MACRO-1l Language Reference Manual -- Describes the 


MACRO-11 relocatable assembler 


Resident Libraries 


When you program under RSX, you can easily use DIGITAL-supplied 
resident libraries (such as RMS-11 and FMS-11) as well as create your 
own resident libraries. Also, because of the Task Builder’s cluster 
library feature, many resident libraries can share the same virtual 
address space in your program. 


You can also use resident libraries under the RT1l1l emulator, but the 
coding is more difficult. Unlike RSX, you must use .PLAS directives 
to map and create address windows inside your task. Coding these 
directives can be quite complex. The Task Builder, on the other hand, 
has options that build tables describing your task and the window to 
map, and automatically includes the code to perform the necessary 
-PLAS directives for you. Thus, RSX is a more practical choice than 
RT11 if you plan to use resident libraries. 


Instruction and Data Space 


The manipulation of Instruction and Data Space (I&D Space) is an 
advanced programming technique that effectively doubles the user’s 
virtual address range from 32K words to 64K words. The memory 
management unit in some PDP-11 processors can relocate data and 
instruction references with separate base address values. Thus, it is 
possible to have a user program of 64K words consisting of 32K words 
of pure instructions or procedure code and 64K words of data -- all 
within a program’s virtual address range. 


Introduction 


Directives for Each Programming Environment 
RSTS/E has three types of directives: 
Oo Monitor ("native" RSTS/E directives) 
o RSX emulator 
o RT1ll emulator 


Monitor directives are processed directly by the RSTS/E monitor (see 
Chapter 3). You can assemble monitor directives using either the 
RSX-based or the RT1l1-based MACRO assembler, and you can use these 
directives in both user programs and run-time systems. (When you 
write a program to run under the RT1l1 run-time system, you must 
precede all monitor directives with a special "prefix EMT"; see 
Chapter 6 for details.) 


The RSX emulator, which is part of the RSTS/E monitor, processes the 
RSX emulator directives. These directives, which have basically the 
same form and function as a subset of the RSX-11M-PLUS operating 
system monitor directives, perform non-file-structured I/O and trap 
handling. You must use the RSX-based MAC assembler to assemble the 
RSX emulator directives, and you can use them only in a user program 
that runs under the RSX emulator. Chapters 4 and 5 describe the RSX 
run-time system environment and emulator directives in detail. 


RT11 emulator directives are processed by the RT11 emulator, which is 
in the RT1ll run-time system. These directives provide most of the 
single-job programmed requests available to MACRO programmers using 
the RT-11 operating system. The RT11 run-time system also provides 
directives for the RSTS/E environment not available under the RT-11 
Operating system. You must use the RT1l1-based MACRO assembler to 
assemble RT11 emulator directives; you can use them only in a user 
program that runs under the RT1l run-time system. Chapters 6 and 7 
describe the RT11 run-time system environment and emulator directives 
in detail. 


Writing or Modifying a Run-Time System 


If you want to modify an existing run-time system or code your own 
run-time system, you can use either assembler. You may find the 
RT11-based programming tools easier to use for this purpose than the 
RSX-based programming tools, mainly because it is easier to link 
run-time systems with the LINK program than with the Task Builder. 
Run-time systems always have a specific address for their top 
(highest) address. When you use LINK, you can specify the top address 
the first time you link the run-time system. But when you use the 
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Task Builder, you have to link your run-time system twice -- once to 
find its size, and again to adjust its top address to the value you 
want. 


Unlike a program, a run-time system can contain monitor directives 
only, not RSX or RT1ll emulator directives. In addition, you must 
store the run-time system file (the product of assembling and linking) 
on the system disk in save image library (SIL) format. To create a 
SIL file, use: 


Oo MAKSIL -- For run-time systems assembled with MAC and linked 
with the Task Builder 

Oo SILUS -- For run-time systems assembled with MACRO and linked 
with LINK. 


Jobs 


Like run-time systems, you can view "jobs" from several angles. To 
the RSTS/E monitor, a job is a unit of work generally associated with 
activity at a terminal. For example, suppose that a user types a line 
at a previously inactive terminal. The monitor creates a job, 
assigning a job number and allocating internal tables for bookkeeping. 
The monitor then passes control to a new-user entry point in the 
primary run-time system. 


The primary run-time system has code at this entry point that causes 
the LOGIN program to be loaded from the system disk and executed. 
LOGIN analyzes what was typed and performs the normal log-in dialogue. 
When LOGIN exits for a valid login, control passes to the default 
keyboard monitor, which waits for further input from the terminal. 


The monitor considers running the LOGIN program and the default 
keyboard monitor, and whatever else occurs at the terminal until the 
user logs out as the same job. (If the log-in sequence was not valid, 
LOGIN exits with the job still logged out. The monitor destroys the 
job and releases the job number.) 


As a MACRO programmer, your awareness of the job concept probably 
focuses on the work space RSTS/E provides for each job, and the fact 
that the run-time system can take part of this work space. Chapter 2 
describes the allocation of work space. 


Chapter 2: General RSTS/E Environment 


This chapter explains how and why one copy of a run-time system, 
shared by many users, can still take up space in each user’s work 
area. The sections in this chapter and their purposes are: 


o How RSTS/E Allocates Memory: Physical and Virtual Addressing 


This section provides some background on memory accessing in 
the PDP-1l. 


o Job Space: High Segment and Low Segment 


This section explains how RSTS/E uses memory accessing to 
define a job space for each user to run programs. 


o Important Installation Options 


This section briefly describes resident libraries and the 
special-case disappearing RSX run-time system. 


o Low-Segment Details: First 512. Bytes of the Low Segment 


This section gives specifics on how the monitor uses the low 
512. bytes of virtual address space. 


o High-Segment Details: Pseudovectors 


This section explains how the monitor and the run-time 
systems use pseudovectors to communicate with each other. 


How RSTS/E Allocates Memory: Physical and Virtual Addressing 


All RSTS/E systems use the memory management feature available on 
PDP-11 computers. This feature extends the addressable memory range 
of the PDP-11 processor by using hardware registers called Active Page 
Registers (APRS). 


The PDP-11 processor handles 16-bit operand addresses, allowing 
reference to 32K words. The PDP-11 is byte-addressable, so the 
address range is from 0 through 2°16 -1 (65535 decimal, 177777 octal), 
which equals 64K bytes or 32K words. With the memory management unit, 
RSTS/E treats a 16-bit address as a relocatable (virtual) address that 
is combined with information in an APR to form an 18-bit (22-bit, for 
the PDP-11/23-PLUS, 24, 44, 70, 73, and 84) physical address. 
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On some PDP-lls (11/44, 11/45, 11/50, 11/55, 11/70, 11/73, and 11/84), 
the memory management unit gives you two areas of 32K words each. You 
can put code (instructions) in one of these areas and data in the 
other. RSTS/E requires that you write your program using special 
techniques to take advantage of both of these areas. This capability 
is known as Instruction and Data (I&D) Space. You have to use the RSX 
tools (specifically TKB) to build programs with separate instruction 
and data sections. 


The PDP-11 Architecture Handbook explains in detail how the APRs 
function. Briefly, an APR consists of two 16-bit registers. These 
registers define a page of contiguous memory. The Page Address 
Register (PAR) defines the physical memory location where the page 
begins. The Page Descriptor Register (PDR) defines, among other 
things, the maximum length of the page and how you can access it (for 
example, read/write or read-only). 


In Figure 2-1, the virtual address of 72322 (octal) identifies APR 3 
and byte 12322 (octal) of the page defined by APR 3. The PAR of APR 3 
indicates a starting address of 146000 (octal) for the page. The 
physical address obtained is 146000+012322, or 160322 (octal). The 
byte offset field in the virtual address is 13 bits long. The maximum 
size of a page, then, is 2°13 bytes, or 4096 words. In other words, 
one APR can map a virtual address range of up to 4K words into an 
equal extent of physical memory. 


Figure 2-1 shows how you can combine a virtual address and a PAR to 
form a physical address in memory. 


General RSTS/E Environment 


Virtual Address 


15 13/12 0 
+-------- Here ee ee ee ee eee et ee ee eee + 
| O 12 1j1 03210 0 2 212 0 212 0 0 21 0 1 
t--- ee eee Hr re re ee ee eee ee ee ee eee + 

3 1 2 3 2 2 

Se eS 

APR byte offset within page 


Page Address Register 


21) (18 17) (6) (0) 
15 12 11 0 
Here ee eee Pre ee ee ee ee eee percent ee ee eee eee + 
| 0 0 0 OO} O O 1 12 0 0 12 1 0 0 0 0} 0 0 0 0 0 0 | 
torre eee e eee Bee eee ee ee ee ee ee ee eee eee Herne eee ee eee + 
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starting address of page 


Physical Address 


Figure 2-1: How a Physical Address Is Formed 
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The 16-bit virtual address defines which APR the system uses and the 
byte offset within that page. The system handles the PAR of the 
indicated APR as though it contains bits 6-17 (6-21 for the 
PDP-11/23-PLUS, 24, 44, 70, 73, and 84) of an 18-bit (or 22-bit) 
physical address, defining the start of the page. 


The memory management unit on the PDP-1l consists of two sets of APRs; 
eight in each set on machines without I&D Space, 16 in each set on 
Machines with separate I&D Space. Since each APR can map a 4K segment 
of virtual memory to physical memory, each set of APRs can provide 
access to 32K words of physical memory on non-I&D Space machines, or 
64K words on machines with I&D Space capability. 


Note 


The PDP-11/44, 45, 50, 55, 70, 73, and 84 have three 
sets of APRs; the additional set is for supervisor 
mode mapping, which RSTS/E does not use. 


The monitor uses one set, called the “kernel mode APRs," to map itself 
in physical memory. It uses the other set, called the "user mode 
APRs," to map the job that is active during the current time slice of 
time-shared processing. 


Figure 2-2 shows the concept of mapping with the APRs. 
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Figure 2-2: Memory Mapping with the APRs 
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On the PDP 11/44, 45, 50, 55, 70, 73, and 84, the RSTS/E monitor can 
take advantage of a hardware function, called I&D space. This 
function lets a program separate its instructions and data into their 
own virtual address space. On these processors, there are actually 
two sets of eight APRs for each mode. RSTS/E uses one set to map 
instructions, and the other set to map data. So, instead of 32K 
maximum job size, there can be 32K of I-space and 32K of D-space. 


The monitor may use this type of mapping, depending on the number of 
small buffers the system manager selects with the INIT option. (The 
RSTS/E System Installation and Update Guide describes INIT.) For 
example, if the number of requested small buffers is large enough, the 
monitor may use D-space APR 1 to map small buffers and I-space APR 1 
to map common routines. 


Figure 2-3 shows a task executing on an I&D-space system without using 
separate I&D space. Note how the I-space APRs and the D-space APRs 
point to the same physical memory. 
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Figure 2-3: Conventional Task Linked to a Library in an I&D-Space 
System 
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Figure 2-4 shows a task using separate I&D Space. Note how the tasks 
I Space APRs and D Space APRs point to different physical memory. 
User programs can also take advantage of I&D space to increase their 
available virtual address space. 
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Figure 2-4: I&D-Space Task Mapping in an I&D-Space System 


Job Space: High Segment and Low Segment 


The RSTS/E monitor is designed to handle work requested by a user 
through an interface: the run-time system. For example, the 
BASIC-PLUS, DCL, RSX, and RT1ll run-time systems (available as part of 
a RSTS/E system) each provide their own keyboard monitor to accept and 
process user commands. 


General RSTS/E Environment 


Some of these run-time systems also contain code to handle their own 
sets of directives, accepting and expanding user program calls to the 
monitor. For example, the RT11 run-time system provides I/0 calls to 
the monitor using the monitor requests native to RT-11, which the 
run-time system translates to the equivalent requests known to RSTS/E, 
which are handled directly by the monitor. 


Thus, the run-time system communicates with both the user program and 
the monitor. Execution control passes back and forth between these 
three independent elements; data is passed between them using 
established ranges of virtual addresses. The monitor must be able to 
access both the run-time system and the user job image at any given 
time. The monitor does this by setting up the run-time system as part 
of the 32K words accessible through the eight user APRs. 


The monitor assigns an area for the run-time system in the high 
portion of virtual address space, called the high segment. The user 
job image (that is, the utility program, compiler, assembler, or 
executable user program that is currently being executed for the job) 
is in the low portion of virtual address space, called the low 
segment. 


Note 


If you are using the monitor’s RSX emulation, there 
is no high segment at all. 


As part of its housekeeping for each job, the monitor keeps track of: 
o Where the currently appropriate run-time system is 
o Where the user job image is 


o What the values were in the program counter register (PC), 
program status word (PSW), and other job-context information 
at the end of the last time slice 


Before the next time slice for the job, the monitor loads the APRs 
with the correct values for the job and loads the PC, PSW, and so 
forth, so execution continues where it left off. 


In any case, the high segment or run-time system takes up some 
multiple of 4K words of virtual address space, due to the APR mapping 
(see the previous section). For example, the BASIC-PLUS run-time 
system, can take from 13 to 16K words of physical memory, depending on 
options selected when the system is installed. Even though the 
physical memory required may be only 13K words, it still requires four 
APRS to map this range, leaving four APRs (or a maximum of 16K words) 
for a user program. 


The monitor uses certain 
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areas within the high segment and the low 


segment to get information from the job (defining what work the 


monitor is to do for it) 


Figure 2-5 shows the job 
first 512. bytes to pass 
system, and the user job 
directives. The monitor 
memory to determine, for 


job is initially entered. 


and to pass information back to the job. 
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Figure 2-5: Job Area in Virtual Memory 
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The following subsections give more detail on these areas: 


o If you are interested in using the general monitor directives 
Chapter 3 describes, you should read "Low-Segment Details: 
First 512. Bytes of the Low Segment." 


o If you want to code your own run-time system or modify one of 
the existing ones and need to know about the pseudovector 
region, you should read "High-Segment Details: 
Pseudovectors." 


o If you are using only the directives Chapters 5 or 7 
describe, the RSX and RT1l1 run-time system directives set up 
the first 512. bytes of memory for you. 


Low-Segment Details: First 512. Bytes of the Low Segment 


The monitor attaches special significance to the first 512. bytes of 
virtual address space in the low segment. The RSX Task Builder and 
RT11 Linker automatically allocate this space. These programs always 
assign relocatable addresses beginning at location 1000 unless you 
request otherwise. If you want to use the general monitor directives 
Chapter 3 describes, your program must fill parts of this area with 
information for the monitor; the monitor passes information back in 
this area. 


Rather than use octal addresses, you can use the COMMON.MAC prefix 
file, which Chapter 3 describes ("Prefix File COMMON.MAC") to assign 
mnemonic names to commonly used addresses and offsets. COMMON.MAC 
does not allocate space, but rather assigns mnemonic names to areas 
within the first 512. bytes of virtual address space. Use the 
mnemonics assigned with COMMON.MAC to make the code more readable and 
easier to maintain. 


Figure 2-6 shows the general regions in this area. Note that a 
run-time system may use some of the areas differently when it assumes 
control. For example, the RSX emulator uses the memory labeled 
default SP stack area as a table of logical units. The Task Builder 
automatically generates a user stack after the first 512. bytes of 
virtual address space. "First 512. Bytes of Low Segment for RSX" in 
Chapter 4 briefly describes how RSX uses the first 512. bytes. 


If you use the general RSTS/E directives, you should reference only 
the areas that are shown with mnemonics provided by COMMON.MAC. The 
mnemonics to the right in Figure 2-6 are assigned through COMMON.MAC. 
A general description of the mnemonics follows Figure 2-6. The 
general monitor calls in Chapter 3 describe specific formats for the 
areas the calls use. 
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Figure 2-6: First 512. Bytes of Low Segment 


KEY (Keyword) 


The keyword defines the job’s status in the time-sharing environment; 
for example, the job’s privilege. Bits in the keyword can be set and 
cleared by the monitor or by the job (either the run-time system or 
the user job image). The job can manipulate some bits in the keyword 
with the .SET and .CLEAR directives. 


The keyword is "refreshed" by the monitor at certain points; for 
example, when a run-time system is entered at P.RUN, where the intent 
is to load and execute a program file in the user job image (.RUN 
directive). For a keyword refresh, the monitor clears bit 15 and bits 
7-0 and sets the remaining bits to indicate the job’s current status. 
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Only seven bits (8-14) are significant to the monitor. You can use 
the other bits in whatever manner you want. 


JFSPRI------------- + 
JFFPP------+---+2-. + | 
JFPRIV----+-+---- + | | 
JFSYS-------- + | | | 
JFNOPR----- + | | | | 
JFBIG----+ | | | | | 
JFLOCK-+ | | | | | | 
| | | | | | | 

15 14 13 12 11 #210 9 8 7 0 

a ter ee eee ee ee eee + 

| | status bits | | 

ee Se + 


The following descriptions apply when the keyword is set to one: 


JFLOCK The job does not want to be swapped. You can change this 
bit with .SET and .CLEAR. When this bit is set, the only 
normal condition that causes the job to be swapped is when 
the job asks for a memory size expansion (see .CORE 
directive) and there is not enough room to do the expansion 
where the job now is in memory. 


JFBIG The job can exceed its private memory maximum (see .CORE 
directive). This bit is set if the job currently has EXQTA 
privilege, usually because the job is running a privileged 
program. JFBIG is an informational bit that the system 
updates whenever the EXQTA privilege is turned on or off. 


JFNOPR The job is not yet logged in. JFNOPR is an informational 
bit that the monitor can alter when the job is logged in. 


JFSYS The job is currently running with temporary privileges. The 
monitor sets JFSYS when a job with insufficient privileges 
needs to run a privileged program. Once the program is run, 
the job can regain temporary privilege by setting this bit 
and can drop privilege temporarily by clearing it. 


Note 


When a job exits from a privileged utility that can 
be executed by users with insufficient privileges, 
the monitor clears this bit so another user cannot 
use the temporary privilege set up for the job. 
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JFPRIV This bit is only for compatibilty with RSTS/E releases prior 
to V9.0. JFPRIV is set if the current job has all of the 
following privileges: HWCFG, SWCFG, SYSIO, RDMEM, and 
WWRITE. 


Note 
Any new software should not reference JFPRIV. 


JFFPP The contents of the hardware floating-point unit (if any) 
should be part of the context of this job. That is, 
information in the floating-point registers should be saved 
and restored along with the rest of the user job image 
during swapping. Any program that uses the hardware 
floating-point unit should set this bit. It can be changed 
with the .SET and .CLEAR directives. 


JFSPRI The job is running with a special run priority: 1/2 level 
higher than normal. This bit can be changed with the .SET 
and .CLEAR directives. The monitor clears JFSPRI when the 
program exits. 


USRSP (User Space) 


COMMON.MAC assigns the value 400 to USRSP. The monitor automatically 
loads this value into the stack pointer register (SP) when a job is 
created. SP is also reset to this value under certain conditions, 
effectively establishing a default user stack area for the job 
beginning at word 376. The user stack area ends at location 170. Any 
attempt to push the stack past location 170 results in a stack 
overflow error that is handled by the run-time system (see the 
description of P.BAD later in this chapter). 


You can change SP if you want. However, any attempt to reset SP to 
any location between 0 and 167 causes a stack overflow error. In 
addition, the monitor resets SP to 400 when a run-time system is 
entered with a .RUN, .CCL, or .RTS directive, and when certain 
catastrophic errors occur, such as a fatal disk error while the user 
job image was being swapped. 


Note 


You need to be aware that the monitor resets SP at 
these times only if you are coding or modifying a 
run-time system. The system does not return control 
to a user program under these conditions, because the 
program cannot recover. 
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FIRQB (File Request Block) 


The FIRQB is the main communication area between the monitor and the 
job for monitor directives that involve file or device operations such 
as open, close, and so forth. Either the run-time system or the user 
job image can use this area: 


o If you use the general monitor directives that Chapter 3 
describes, your MACRO program must store values in the FIRQB 
before issuing some of the directives. 


o If you choose to use the directives in the RSX emulator or 
the RT11 run-time system, the RSX or RT1l1 emulation code 
intercepts the request, sets up the FIRQB and other relevant 
areas, then calls the monitor to handle the request. 


Figure 2-7 shows the general format of the FIRQB, with all mnemonics 
that COMMON.MAC assigns. In addition, the size of the FIRQB (32. 
bytes) has the mnemonic FQBSIZ. 
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‘Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre eee eee eee eee Se + 
L|SAAISAIA11111 461117177 \ returned status | 0 FIRQB 

Se tee eee ee ee eee ee ee eee + 
FQFUN 3 | CALFIP/.UUO subfnc. | job number * 2 | 2 FQJOB 
terre eee eee ee ee eee eee Herr ee eee eee eee eee + 
FOQSIZM 5 | MSB of file size | channel number * 2 | 4 FQFIL/ 
pe eee eee eee eee eee pene e eee eee eee eee + FQERNO 
a project number | programmer number | 6 FQPPN 
tener eee ee eee ee eee Sr + 
i file name in RAD50 format | 10 FQNAM1 
| (2 words) | 
13 | 2 
Sa Sr + 
15 | file type in RAD50 format (1 word) | 14 FQEXT 
tere re ee eee eee ee ee eee terre eee ee eee eee + 
py ae LSB of file size | 16 FQSIZ 
terre eee ee ee ee eee Se + 
21 | buffer length | 20 FQBUFL/ 
tec eee ree ee ee eee tere cre eee eee ee ee eee + FQNAM2 
23. || mode | 22 FQMODE 
Sr tern er ee eee ee eee + 
25. | status flags | 24 FQFLAG 
Herr eee eee eee eee Se + 
FQPROT 27 | prorectoee code | =0, prot. code real | 26 FQPFLG 
Se tener eee eee eee eee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
pee eee ee eee eee eee Se + 
33 | =0,unit number real | device unit number | 32 FQDEVN 
tere ree ee ee ee ee eee eee tener nee ee ee ee eee eee + 
35 | cluster size | 34 FQCLUS 
Sr Se + 
37 | nunber of entries in directory lookup | 36 FQNENT 
teen ee eee ee ee ee eee Here ee eee eee + 


Figure 2-7: General FIRQB Format 


XRB (Transfer Request Block) 


The XRB is the main communication area between the monitor and the 
user for monitor directives handling file or device I/0. It is also 
the area in which the monitor stores information requested by 
straightforward information-request calls. As with the FIRQB, the 
general monitor directives (see Chapter 3) require that you store and 
retrieve information directly to and from the XRB. The RSX and RT1l 
emulators handle additional directives, which they translate to calls 
using the XRB (see Chapters 5 and 7). 
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Figure 2-8 shows the general format of the XRB, with all mnemonics 
that COMMON.MAC assigns. In addition, the size of the XRB (14. bytes) 
has the mnemonic XRBSIZ. 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herre ee ree eee ee eee eee tener ee eee ee eee eee + 
1 | buffer size in bytes | 0 XRLEN 

Herc errr ee eee ee eee ee Se + 
a | number of bytes transferred | 2 XRBC 
Se 0 + 
5. | buffer address | 4 XRLOC 
tee ee eee ee ee ee eee eee pene ee ee ee ee ee eee + 
XRBLKM 7 | MSB of block number | channel number * 2 | 6 XRCI 
Henne ee ee ee ee ee eee eee tere ee tee ee eee ee eee eee + 
11 | LSB of block number | 10 XRBLK 
Here cee ee ee eee ee eee terre ee ee ee ee ee eee eee + 
13 | wait time for terminals | 12 XRTIME 
ferret eee eee ee ee ee eee terre ee ee eee ee ee eee eee + 
15 | device modifier | 14 XRMOD 
Sr t----- eee ee eee terete ee + 


Figure 2-8: General XRB Format 


A buffer, as defined by XRLOC for its start and (XRLOC+XRLEN)-1 for 
its last byte, can be either an input buffer or an output buffer. 
RSTS/E uses input buffers to read data into user memory and output 
buffers to write data from user memory. These buffers must lie wholly 
within either the job image (low segment), or the run-time system 
(high segment), or in a window mapped to some library. 


For input buffers, the value passed in XRB+XRBC must be zero. For 
output buffers, the value passed in XRB+XRBC is the number of bytes to 
be sent and cannot be zero if the value in XRB+XRLEN is nonzero. 
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In addition, input buffers are subject to the following rules: 


o If the buffer is in the low segment, the address defined by 
the contents of XRB+XRLOC must be greater than 170 to avoid 
destroying the job-context data used in swapping the job. 


o If the buffer is in the high segment, it must not fall within 
the pseudovector region. That is, it must not fall above the 
location P.OFF. In addition, the run-time system must 
currently be mapped read/write because the monitor is writing 
data to the buffer for the receive (see PF.RW bit description 
in P.FLAG word). 


o If the buffer is in a library window, the library must be 
installed as read/write and must be attached and mapped 
read/write. 


CORCMN (Core Common Area) 


The CORCMN is used as a common data exchange area when it is necessary 
to exchange lengthy data (such as strings) between the monitor and the 
job or between programs running under the same job number. 


For example, the monitor uses CORCMN to pass to the job a string that 
is the full name of a command that has been recognized as a valid 
Concise Command Language (CCL) command. The RSTS/E CCL lets users 
type one-line commands to call utilities that might otherwise require 
several input lines from the terminal. For example: 


CCL Form 
S$ PIP FILE1.=FILE2. 


$ 


Regular Form 


$ RUN SPIP 
*FILEL.=FILE2. 
*CTRL/Z 


$ 


To centralize decoding, the monitor analyzes CCL commands by comparing 
them to those defined by the system manager (usually during system 
start-up). With the .CCL directive, a job can ask the monitor to 
analyze a string to see if it is an acceptable command. If it is, the 
monitor passes control to the run-time system associated with that CCL 
command and passes the command and any arguments to the job in the 
CORCMN area. 
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The general format of the CORCMN area is: 


tee ener ee ee ee eee ee ten ee eee ee ee eee eee eee + 
| byte 1 of string | number of bytes | 460 CORCMN 
| | ain string | 
ee teen eee eee ee eee eee + 

| byte 3 of string | byte 2 of string | 462 

tee eee eee ee eee eee tenner ee ee ee eee eee + 


USRPPN, USRPRT, USRLOG 


This area is set up using the .ULOG directive to store the assigned 
project-programmer number (USRPPN), default protection code (USRPRT), 
and assigned logical device names (USRLOG), which the monitor then 
uses when an .FSS directive is executed. The .FSS directive causes 
the monitor to convert a file name string to the standard RSTS/E file 
specification format; that is, to the FIRQB format. 


The .ULOG and .FSS directives also let you define and use some 

nonstandard area to contain these values (see Chapter 3). However, 
the .ULOG directive sets up 18. words in the same basic format; the 
-FSS directive expects these values in the same relative locations. 


Note 


All manipulation of this data must be done using the 
.ULOG directive. Direct program access to this data 
will not be compatible with possible future 
enhancements and will not be supported. 


High-Segment Details: Pseudovectors 


The monitor and the run-time system use the pseudovector region to 
communicate with each other. Figure 2-9 shows the general layout of 
this area. As with the low 512. bytes of virtual address space, the 
file COMMON.MAC assigns mnemonic names to locations in this area. 
These names are shown to the right in Figure 2-9. The following text 
describes each of these areas in detail. If you want to modify or 
code your’ own run-time system, the format and meaning of these areas 
is important. Otherwise, you might want to examine them to see how 
the run-time system and the monitor communicate. 
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Har ee ee ee ee eee + 

| flags describing the run-time eyeren | 177732 P.FLAG/ 
re eee + P.OFF 
| normal executable file type | 177734 P.DEXT 
i + 

| (reserved) 177736 

te ne ee ee ee ee ee eee eee eee + 

| minimum size, in K words, of user job image | 177740 P.MSIZ 
tn nn ee ee ee ee ee eee + 

| exception address for FIS hardware option | 177742 P.FIS 
tr ee ee ee ee ee eee + 

| (reserved) | 177744 

He re ee ee re ee ee eee + 

| (reserved) | 177746 
i ee ee + 

| entry point for new user | 177750 P.NEW 
5 ee + 

| entry point for new user with program to run | 177752 P.RUN 
He ee ee ee ee ee eee eee + 

| exception address for various "bad" errors | 177754 P.BAD 
Her ee ee ee ee ee ee eee + 

|exception address for BPT instruction and T-bit | 177756 P.BPT 
Hr rr ee ee ee ee ee eee ee + 

| exception waavexs for IOT instruction | 177760 P.IoT 
He rn ee re ee eee + 

{exception address for nonmonitor EMT instruction| 177762 P.EMT 
pr ee ee eee eee ee eee + 

| exception sAaces s for all TRAP instructions | 177764 P.TRAP 
pr ee ee ee eee + 

| exception sadiece for FPP or FPU | 177766 P.FPP 
pn ee ee ee ee ee eee + 

| rege oy address when user types one CTRL/C | 177770 P.CC 
os + 

| exception address when user types two CTRL/Cs | 177772 P.2cCCc 
+ emp eae rem nmr ee cee eoeween ewe we eee ew ee eee eee el hl hr hh hl hl hl le + 

| maximum size (in K words) of user job image | 177774 P.SIZE 
ee + 

| (reserved) | 177776 
i rr + 


Figure 2-9: 


In general, the pseudovector region contains: 


Format of Pseudovector Region of High Segment 


o Values and flags that define the capabilities of the run-time 
system for the monitor. For example, one flag indicates 
whether the run-time system has a keyboard monitor. 


o Addresses pointing to locations in the run-time system where 
the monitor is to pass control when certain conditions occur. 
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These addresses fall into three categories: 


- Addresses for Synchronous Exceptions. Control passes to 
these locations when the job executes an instruction that 
causes a trap to the monitor. The monitor passes control 
to the run-time system along with the contents of the 
program counter (PC) and program status word (PSW). The 
term "synchronous" is used in the sense that the trap 
occurs at the same time as (and is a direct result of) 
some instruction executed by the job. These traps may or 
may not indicate an error. For example (except for the 
PDP-11/23 PLUS or 11/24, if the job executes an 
instruction with an odd address, control passes to one of 
these trap addresses. If the job simply executes a BPT 
instruction, control passes to another of these 
addresses. 


- Addresses for Asynchronous Exceptions. Control passes to 
these locations as a result of some event, which can be 
either of the following: 


o External to the execution of the job (for example, 
the user types a CTRL/C at the terminal) 


o Internal but asynchronous process (such as an error 
in the hardware floating-point processor, whose 
execution overlaps that of the PDP-11 CPU) 


When such conditions occur, control passes to the 
monitor, which passes control to the run-time system, 
along with the contents of the PC and PSW. If a 
floating-point trap occurred, the monitor also passes 
along the floating exception code (FEC) and floating 
exception address (FEA). For the asynchronous traps, the 
PC and PSW do not refer to the instruction that caused 
the trap, but to the instruction that was executing in 
the central processor when the trap occurred. 


- Entry Point Addresses. The monitor passes control to the 
run-time system at entry-point addresses when some major 
transition point is reached for the job. For example, 
when you type a RUN or CCL command at the terminal, the 
monitor passes control to an entry point in the 
appropriate run-time system, to load and execute the 
requested program. 
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Note 


The term pseudovector arises from the relationship of 
some of these (one-word) trap addresses in the 
pseudovector region to the (two-word) vector 
addresses in kernel-mode memory set up to handle 
error traps and interrupts in the PDP-11. When the 
RSTS/E monitor receives control as a result of a trap 
to certain of these vector addresses, it passes 
control on to the run-time system at addresses 
specified in the pseudovector region. 


Normally, you code the contents of the pseudovector region as part of 
the run-time system file. However, the INSTALL/RUNTIME SYSTEM 
command, used to define a file as an auxiliary run-time system, has 
qualifiers that cause the monitor to override certain portions of the 
-pseudovector region in the file and use values assigned in the INSTALL 
command. For example, one bit in one word of the pseudovector region 
states whether the run-time system is read/write or read-only when it 
is loaded in memory. Normally, this would be read-only, but for 
debugging a run-time system with the Octal Debugging Tool (ODT), which 
allows you to change memory, the run-time system must be read/write. 
The /NOREAD_ONLY qualifier in the INSTALL command lets you tell the 
monitor that until further notice, this run-time system is read/write, 
regardless of what is specified in the pseudovectors. The RSTS/E 
System Manager’s Guide describes the INSTALL/RUNTIME_SYSTEM command. 


Run-Time System Capability and Default Definitions 


The following mnemonics refer to values and flags that define run-time 
system capabilities for the monitor. 


P.OFF 


Use the P.OFF mnemonic to define the first word of the pseudovector 
region. It is currently set equivalent to 177732, the same as P.FLAG. 
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P.FLAG 


The monitor expects the P.FLAG word to be set with flags that define 
the capabilities of the run-time system: 


PF.KBM------------- + 
PF.1US+---------- + | 
PF.RW---------- + | | 
PF.NER------- + | | | 
PF.REM----- + | | | | 
PF.CSZ---+ | | | | | 
en an a 
15 14 2123 12 11 #10 9 8 7 | 0 
Here ee ee ee ee eee ee eee torr ere eee we ee ee eee + 
| flags |(prefix EMT code if PF.EMT=1) | 
Se Herr er re ee ee eee + 


PF.EMT 


This bit is set to indicate that the run-time system wants to handle a 
call that would normally be handled by the monitor. To show how the 
bit works, it is necessary to first describe what normally happens 
when a monitor directive is translated and executed. 


All of the monitor directives that this manual describes are 
translated to emulator trap (EMT) instructions. The direct monitor 
calls are one-for-one translations; that is, one call is translated to 
one EMT (see Chapter 3). The code to process the call is in the 
monitor itself. 


The RSX and RT11 emulator calls may be translated to more than one 
instruction, but the code always contains an EMT. In addition, the 
direct monitor calls are translated to an EMT with a low byte that is 
an even number within the range 0 to 114 (octal). When such an 
instruction is executed, control transfers directly to the monitor, 
the call is processed, and control returns to the instruction 
following the EMT. 


An EMT instruction with an odd value in the range 1 to 113 in the low 
byte, or any value in the range 115 to 377, also transfer control to 
the monitor. The monitor examines the low byte, discovers that the 
EMT is not one of its own, and transfers control to the run-time 
system at the entry point defined by location P.EMT in the 
pseudovector region. 


Now the PF.EMT bit is set to one to indicate that the run-time system 
wants to process EMTs that are normally processed by the monitor, that 
is, with an even low byte in the range 0 to 114. When PF.EMT is set 
to one, all EMTs cause control to pass to the run-time system at the 
P.EMT entry point, except those immediately preceded by a special 
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prefix EMT -- an EMT whose low byte is equal to the low byte of 
P.FLAG. 


Specifically, when PF.EMT equals one, the monitor handles all EMT 
instructions as follows: 


o Any EMT whose low byte is not equal to the low byte of P.FLAG 
causes control to pass through the monitor (unprocessed 
except for examination), and back to the run-time system at 
the address contained in the P.EMT word. 


o An EMT whose low byte is equal to the low byte of P.FLAG 
causes control to pass to the monitor, which looks at the 
word following the EMT with the special code; that is, at the 
word in location (PC)+2. Action is taken according to the 


value of this word: 


ia. sesdaneaceniews! : 


(PC)+2 = NO | Pass control to | 

an EMT instruction? (P.EMT) | 

tree eee ee ee ee ee eee + 

YES 
prt eee ee ee ee eee + 
NO | Pass control to | 
Low byte of (PC)+2 (P.EMT) 

even, 0 - 114? +-- ee ee ee ee ee ee eee + 


In other words, the run-time system does special processing for all 
EMTs, except those preceded by a special prefix EMT. The RT1l1l 
run-time system uses this feature so it can emulate the RT-11l 


operating system’s directives properly. 
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PF.CSZ 


For a user job image executed as a result of a .RUN directive, the 
monitor preallocates memory based on information provided by the 
run-time system under which the image is executing. When this bit is 
set, the monitor preallocates memory based on the size of the file 
referenced in the .RUN directive: 


space (in K words) = (filesize + 3)/4 


Filesize is the number of 512-byte blocks required for the file on 
Gdisk. (The division by four is performed because there are four 
512-byte blocks in 1K word. The addition of three rounds any fraction 
of the integer divide to the next whole integer.) 


When PF.CSZ is clear, the monitor preallocates memory for the image 
according to the value specified in the P.MSIZ word of the 
. pseudovector region. 


PF.REM 


When the PF.REM bit is set, the monitor immediately removes the 
run-time system from memory when no job is using it. When this bit is 
clear, the monitor leaves the run-time system in memory until the 
Space is actually needed by something else. 


PF.NER 


When this bit is set, the monitor does not log errors occurring within 
the run-time system to the system error log. 


PF.RW 


When this bit is set, the monitor maps the run-time system as 
read/write. (See the read/write feature of the Page Descriptor 
Register of an APR, in the section, "How RSTS/E Allocates Memory: 
Physical and Virtual Addressing.") This is a useful feature when 
debugging a run-time system. In normal operation, this bit should be 
clear, indicating that the run-time system is to be mapped read-only. 


PF.1US 


When the PF.1US bit is set, the monitor allows only one job to use the 
run-time system; that is, it is not handled as shareable code. 


PF .KBM 


When this bit is set, the monitor expects that the run-time system can 
function as a keyboard monitor. Note that the run-time system can 

function as a job keyboard monitor only when this bit is set. See the 
-RTS directive in Chapter 3 for a discussion of job keyboard monitors. 
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P.FLAG COMBINATIONS 


The PF.1US, PF.RW, PF.NER, and PF.REM bits are useful flags when you 
are debugging a run-time system: 


© PF.1US limits access to the run-time system to one user. 


o PF.RW is necessary if you want to use the ODT routine to 
change memory. 


o PF.NER keeps the run-time system from logging useless errors 
while debugging. 


Oo PF.REM ensures that the run-time system will be reloaded each 
time it is used. (Otherwise, an old copy might still remain 
in memory when you really wanted to debug a new copy.) 


P.DEXT 


You can set this word to three Radix-50 characters that the monitor 
uses as a default runnable file type. If a .RUN directive executes 
with no file type given, the monitor scans its list of installed 
run-time systems in the order they were installed (see Chapter 3). 


Note 


The order of installation shows up in the display 
that the SHOW RUNTIME_SYSTEM command produces. 


For the first run-time system in the list (the primary run-time 
system), the monitor looks for a file with the file name given in the 
-RUN and a type that is the default type for the run-time system. 

(For example, the BASIC-PLUS run-time system fills this word with 
-BAC; RT11, with .SAV; and RSX, with .TSK. If the run-time system has 
no runnable file type, this word should be set to zero.) If such a 
file is found, it is set up for the .RUN. If no such file is found, 
the monitor searches for a file with the given file name and the next 
run-time system’s default runnable file type, and so forth. Note that 
the order in which the file types are chosen does not depend in any 
way on the run-time system executing the .RUN. 


P.MSIZ 


The P.MSIZ word gives the minimum allowable size for a user job image, 
in K words, for this run-time system. The monitor uses this value as 
a check when the job issues a .CORE directive to change the size of 
the user job image in memory (see Chapter 3). The value of P.MSIZ 
must be an integer between 1 and the value in P.SIZE, inclusive. 
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P.SIZE 


The P.SIZE word contains the maximum size, in K words, that a user job 
image can be for this run-time system. The monitor uses this value as 
a check when a job issues a .CORE directive to change the size of the 
user job image in memory. P.SIZE must be an integer between 1. and 
32., inclusive. The effective upper limit is 32. minus the size of 
the run-time system, rounded up to a multiple of four. (Remember that 
the APR mapping requires that space for the run-time system be 
allocated in units of 4K words.) Thus, a run-time system that required 
5K words could set an upper limit here of 24. (32.-8.). However, it 
could set P.SIZE to some smaller value. 


Synchronous Exception Handler Addresses 


These mnemonics refer to locations in the run-time system where 
control is to pass for synchronous exceptions. 


P.FIS 


The monitor interprets the P.FIS word as the trap address for the 
hardware floating-point instruction set available on the PDP-11/35 and 
40. Whenever an instruction from this set is executed that causes a 
trap to the kernel mode vector at 244, the monitor passes control to 
the run-time system at the location specified by the contents of the 
P.FIS word. 


This exception pushes two words onto the user’s SP stack: the contents 
of the PC and PS registers at the time of the exception. For example: 


SP— > (PC) at the time of the exception 
(PS) at the time of the exception 
word to which SP pointed before the exception 


Whatever action the run-time system wants to take for this exception 
should be done at the location specified by the contents of P.FIS. A 
return from interrupt (RTI) instruction returns control to the point 
where it was when the exception occurred. 


P.BAD - Synchronous Exceptions 
The monitor passes control to the run-time system at the location 
specified by the contents of P.BAD when any of the following 


synchronous exceptions occur: 


o Memory management unit exception (trapped to kernel mode 
vector at 250). 


o The job tries to execute a reserved instruction (trapped to 
kernel mode vector at 10). 
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o The job issues an instruction with an odd address (trapped to 
kernel mode vector at 4). 


This exception pushes two words onto the user’s SP stack: the contents 
of the PC and PS registers at the time of the exception. For example: 


SP——> (PC) at the time of the exception 
(PS) at the time of the exception 
word to which SP pointed before the exception 


The monitor returns an error code in the first byte of the FIRQB so 
the run-time system can determine which error occurred. The error 
codes are: 


B.4 Odd address 
B.10 Reserved instruction 
B.250 Memory management unit exception 


The run-time system is responsible for processing these errors in 
whatever manner it sees fit. In general, most run-time systems 
provided with RSTS/E systems report the error, using the UU.ERR 
subfunction of the .UUO directive and perhaps print the PC value from 
the top of the stack. You can use an RTI instruction to return 
control to the point where it left off when the exception occurred. 
Note that some asynchronous exceptions also use this address. 


P.BPT 


The P.BPT word contains the exception address for a BPT instruction 
and for T-bit exceptions. When the job issues a BPT instruction or a 
T-bit exception occurs (to the kernel mode vector at 14), the monitor 
passes control to the run-time system for the job at the address 
specified by the contents of this word. 


This exception pushes two words onto the user’s SP stack: the contents 
of the PC and PS registers. For example: 


SP— >» (PC) at the time of the exception 
(PS) at the time of the exception 
word to which SP pointed before the exception 


The run-time system processes these exceptions in any fashion it sees 
fit at the location specified by the contents of P.BPT. The RTI or 
RTT instructions can be used to return control to the user’s program 
at the point where it was when the exception occurred. 


P.IOT 


The P.IOT word contains the exception address for an IOT instruction. 
Whenever the job issues an IOT instruction (trapped to kernel mode 
vector at 20), the monitor passes control on to the run-time system at 
the address specified by the contents of this word. 
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This exception pushes two words onto the user’s SP stack: the contents 
of the PC and PS registers at the time of the exception. For example: 


SP— > (PC) at the time of the exception 
(PS) at the time of the exception 
word to which SP pointed before the exception 


The run-time system can process the exception in any fashion it sees 
fit. You can use an RTI instruction to return control to the point 
where it was when the exception occurred. 


P.EMT 


This word contains the location to which control is transferred for 
nonmonitor EMT instructions; that is, for EMT instructions whose low 
byte is odd within the range 1 to 113 or any value in the range 115 to 
377. If the PF.EMT bit is set in the P.FLAG word in the pseudovector 
region, control is transferred here for all EMT instructions except 
those preceded by the special prefix EMT, as described previously. 


The exception pushes two words onto the user’s SP stack: the contents 
of the PC and PS registers at the time of the exception. For example: 


SP—> (PC) at the time of the exception 
(PS) at the time of the exception 
word to which SP pointed before the exception 


The run-time system is responsible for processing the EMT as it sees 
fit. You can use the RTI instruction to return control to the point 
where it was when the exception occurred. 


Note 
All EMT instructions are reserved for use by DIGITAL. 
P.TRAP 


This is the location to which control is transferred for all TRAP 
instructions (operation codes 104400 through 104777, inclusive). 
Whenever the job executes such an instruction (trapped to kernel mode 
vector 34), the monitor passes control to the run-time system at the 
location specified by the contents of this word. 


This exception pushes two words onto the user’s SP stack: the contents 
of the PC and PS registers at the time of the exception. For example: 


SP— > (PC) at the time of the exception 
(PS) at the time of the exception 
word to which SP pointed before the exception 


The run-time system is responsible for processing the exception as it 
sees fit. You can use an RTI instruction to return control to the 
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point where it was when the exception occurred. 


Asynchronous Exception Handler Addresses 


These mnemonics refer to locations within the run-time system where 
control is to pass for asynchronous exceptions. 


P.FPP 


This location is the exception address for the hardware floating-point 
processor (FPP) for the PDP-11/34A, 44, 45, 50, 55, 60, 70, 73, and 84 
asynchronous unit or the KEF11-AA or FPF-11 for the PDP-11/23-PLUS and 
24. Whenever the unit takes an exception trap (to kernel mode vector 
at 244), the monitor passes control to the run-time system at the 
location specified by the contents of this word. The Floating-point 
Exception Code (FEC) and Floating-point Error Address (FEA) of this 
unit are not otherwise accessible. 


Therefore, the monitor pushes these two values onto the user’s SP 
stack, in addition to the contents of the PC and PS registers at the 


time of the interrupt. For example: 
SP— > FEC 
FEA 


(PC) at the time of the exception 
(PS) at the time of the exception 
word to which SP pointed before the exception 


The run-time system can process the exception as appropriate, clean 
the stack (remove the FEC and FEA), and issue an RTI instruction to 
return control to the user’s program at the point where it was when 
the exception occurred. 


P.CC 


This is the location to which control passes when a CTRL/C is entered 
at any terminal on any channel that this job accepts. The monitor 
stops further programmed output for the job (CTRL/O effect) and 
cancels any pending character output. 


The user’s SP stack is modified at entry. For example: 


SP— > (PC) at the time of the exception 
(PS) at the time of the exception 
word to which SP pointed before the exception 


The run-time system can process the CTRL/C as you want. All run-time 
systems supplied with a RSTS/E system abort the job, unless the user 
job image has indicated that it wants to handle CTRL/C traps itself 
(see the SCCASS and the .SETCC directives). 
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P.2CC 


This is the exception address taken when the user enters a second 
CTRL/C before the run-time system has been able to respond to the 
first CTRL/C. (That is, the monitor has received two CTRL/Cs before 
it has been able to pass control to the run-time system at the 
location specified by the contents of P.CC in the time-sharing 
environment. ) 

As with one CTRL/C, when the P.2CC point is entered, further 
programmed output is canceled (CTRL/O effect), and any pending 
character output is canceled. Two words are pushed onto the user’s SP 
stack. For example: 


SP— >» (PC) at the time of the exception 
(PS) at the time of the exception 
word to which SP pointed before the exception 


The run-time system can process the condition as you want (BASIC-PLUS 
exits immediately, returning control to the P.NEW entry point in the 
default keyboard monitor). An RTI instruction would return control to 
the point where the program left off, but this annoys the user who 
entered the two CTRL/CS expecting to get out. 


P.BAD ~- Asynchronous Exceptions 


The monitor passes control to the location specified by P.BAD whenever 
any of the following asynchronous errors occur: 


o The user’s SP stack overflows. 


o A fatal disk error occurs when the job is swapped. The 
Original contents of the user job image are lost. 


o A memory parity fault occurs in the user job image. The 
Original contents of the user job image are lost. 


o A fatal disk error occurs when a run-time system or resident 
library is loaded. Control passes to P.BAD in the default 
keyboard monitor when the load error occurs for a run-time 
system. 


None of these errors are recoverable. An error is returned in the 
first byte of the FIRQB to indicate which error occurred, KEY is 
refreshed, and the contents of the general registers (RO through R5) 
are random. SP is reset to the value USRSP. 


In general, most run-time systems provided with RSTS/E systems report 
the error, uSing the UU.ERR subfunction of the .UUO directive, and 
also the ??Program lost-sorry message (UU.ERR call with FUCORE value). 
Then, the run-time systems exit to the job keyboard monitor, using 
-RTS. The ??Program lost-sorry message prints to warn you that user 
logical values have been destroyed. 
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'/ The error codes that RSTS/E returns in the first byte of the FIRQB 
are: 


B.STAK The user’s SP stack overflowed 

B.SWAP Fatal disk error on swap 

B.PRTY Memory parity fault 

NRRTS Fatal disk error on run-time system or resident library load 


Control is also transferred to P.BAD for some synchronous exceptions. 


Entry Points 


These mnemonics refer to locations within the run-time system where 
, control is to pass at certain transition points for the job. 


P.NEW 


The monitor passes control to this entry point under the assumption 
that new user or next request processing is to be done. Compare this 
to the P.RUN entry point, where a specific program is to be run under 
this run-time system. P.NEW is commonly used as the entry point to 
switch back to a job’s keyboard monitor. For example, the .EXIT 
directive passes control:'to this entry point in the system default 
keyboard monitor. You can use the .RTS directive to pass control to 
P.NEW in a job’s keyboard monitor or a specifically named run-time 
system. Note that a job can establish its own job keyboard monitor, 
which is different from the default keyboard monitor (see Chapter 3). 


By examining KEY and the XRB, the run-time system can determine how 
and by whom it was entered at P.NEW, if this is significant. 
(Run-time systems that do not have keyboard monitors would probably 
want to exit (using .EXIT) to the default keyboard monitor at P.NEW. ) 


The three conditions under which control passes to the P.NEW entry 
are: 


o Brand new job on the system -- In this case, JFNOPR (bit 12 
in KEY) is set (the job is not yet logged in), and the words 
at location XRB+2 and XRB+4 are zero (the monitor requested 
the entry, not a run-time system). This indicates that the 
monitor has passed control to this location, having received 
input over channel zero in a logged-out state (occurs only 
for the primary run-time system). 


The run-time system should run some predetermined program to 
read (.READ directive) the input line that the monitor has 
buffered. For example, DCL executes SY:[{1,2]LOGIN.* (the 
LOGIN utility) in this case. 
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o Switch to this run-time system when job logged out -- In this 
case, JFNOPR (bit 12 in KEY) is set, and the name of the 
calling run-time system is given as two RAD50 words in 
locations XRB+2 and XRB+4. The calling run-time system is 
the run-time system under whose control the directive was 
issued that caused the switch. 


For this case, the run-time system should issue a logged-out 
prompt message. For example, the BASIC-PLUS run-time system 
prints "Bye" and returns control to the monitor. (Normally, 
control does not pass to the run-time system in this case. 
If LOGIN does not recognize the line that it read (as in 
previous case), it kills itself, destroying the job and 
returning control to the monitor.) 


o Switch to this run-time system when job logged in -- In this 
case, JFNOPR (bit 12 in KEY) will be clear. The name of the 
calling run-time system is given as two words of RAD50 in 
locations XRB+2 and XRB+4 or is zero if this job was just 
created by UU.JOB (see Chapter 3). 


For this situation, the run-time system should issue its 
logged-in prompt and attempt to read the next command from 
the terminal open on channel zero. BASIC-PLUS prints 
"Ready", DCL prints "$", RSX prints ">", and RT1ll prints ".", 
Then, all wait for further input. 


Keyboard monitors should read channel zero (the job’s terminal) using 
the keyboard monitor wait feature of .READ. The monitor will kill 
jobs that execute this read in a logged-out state; otherwise, it is an 
infinite-wait read. 


The monitor usually does some housekeeping for the job at the time the 
P.NEW entry point is entered. Specifically, the word at location 
FIRQB+FQJOB is always set to two times the job number assigned by the 
monitor when the job was created, and KEY is refreshed with current 
information about the job. Third-part privilege checking is turned 
off if it was on (see UU.3PP). Furthermore, SP is reset to 400 (see 
USRSP description), and all the general registers (RO through R5) 
contain zero. Note, however, that 1/0 channels are left open. 
Therefore, the run-time system should reset all I/O channels. 


On exit from privileged programs, some additional clean-up is done: 
o Temporary privileges are dropped 
o User memory is cleared (upwards from location 1000) 


o User job image size is reset to the value in P.MSIZ 
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Note 


This housekeeping is not done if a specific request 
is made to pass control to a run-time system without 
changing the job-context information (see the .RTS 
directive). 


The following information exists in the XRB at the time the P.NEW 
entry point is entered: 


XRB on P.NEW Entry 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
5 + 
1 | 1 for switch without housekeeping; else 0 | 0 
| | 
i ee + 2 
| name of the calling run-time system | 
5 (2 words in RAD50 format) | 4 
ee es + 
7 | -1 if calling RTS = new RTS; else 0 | 6 
| | 
2 ee + 10 
| whatever values were here | 
13 | when the switch was made | 12 
| | 
15 terre err ee ee ee re ee ee ee ee eee + 14 
XRB+0 This word contains a value of one, if control was 


transferred by an .RTS directive using the switch without 
changing the job-context option (see Chapter 3). 


XRB+2 The two words beginning here contain the name of the calling 
run-time system, in RAD50 format. If control was 
transferred here directly by the monitor, these two words 
contain zero. 


XRB+6 This word contains minus one if the calling run-time system 
is the same as the one that now has control. This word is 
zero otherwise; that is, if the calling run-time system is 
not the same as the called run-time system. 


XRB+10 The contents of the next three words will be the same as 
they were when the switch occurred. That is, data can be 
passed from run-time system to run-time system here. If 
control has been transferred to P.NEW directly by the 
monitor, these three words are zero. 
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P.RUN 


The monitor passes control to the P.RUN entry point when an executable 
program is to be run for a job under control of this run-time system. 
This can occur as the result of either a .RUN or a .CHAIN directive 
(in which a job has directly asked for a file to be run) or a .CCL 
directive (in which a job has asked the monitor to check a string to 
see if it is a valid CCL command, and if so, execute the appropriate 
file). 


The monitor opens the file to be run (a disk file) on channel 15. 
However, the file has not been read; it is up to the run-time system 
to load and execute the file. The run-time system should also reset 
all I/O channels except 15, in case they are open. 


The monitor performs the same housekeeping operations as with P.NEW 
(reset the stack, and so on). In addition, if the program to be run 
is a privileged program, and the caller does not have all of the 
program’s privileges, the monitor sets the JFSYS bit in KEY, saves the 
current privileges, and adds the program’s privileges to the current 
privileges. 


The monitor passes data to the run-time system in the XRB, FIRQB, and 
KEY areas of the user job image (low segment). 


XRB on P.RUN Entry 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
i i + 
1 | flag bits describing entry conditions | 0 
Hn ee ee ee ee ee ee ee ee ee ee ee eee + 
3) | 2 
| name of run-time system which issued | 
5 the call to this one | 4 
Here ee ee ee ee ee ee eee ee ee ee ee eee + 
VT | random value | 6 
ae + 
ll | | 10 
| | 
13 | same value as when the caller | 12 
| issued the .RUN or .CCL | 
|e + 14 


XRB+0 


XRB+2 


XRB+6 


XRB+10 
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This word contains flag bits that describe the entry 
conditions. (The STATUS variable in BASIC-PLUS returns 
these values. ) 


Bit Meaning 


15 When set, indicates the entry was made as the result 
of a .CCL directive. When clear, indicates the entry 
was made as the result of a .RUN or a .CHAIN 
directive. 


14 When set, indicates the caller issued a .CCL 
directive with a /DETACH switch, with the intent that 
this run-time system executes the file in detached 
mode. It is up to the run-time system to take action 
on this flag. You can detach a job by using the 
UU.DET subfunction of the .UUO directive; see Chapter 
ie 


13 When set, indicates that the caller issued a 
directive with a /SIZE switch; that is, the file is 
to be run at a specific size. The size is given in 
bits 0-7. It is up to the run-time system to set the 
size as indicated (see the .CORE directive). 


12-8 Reserved for future use. 


7-0 If the value of these bits is zero, then no special 
size for this program run is called for. If the 
value is greater than zero, it indicates the size, in 
K words, that the program should be run at. If the 
value is less than zero, the absolute value indicates 
an increment, in K words, to the size that the 
program would normally run at. 


These two words contain the name of the run-time system 
under which the .RUN, .CHAIN, or .CCL directive to this 
run-time system was issued, in RAD50 format. 


The contents of this word are random. 
The three words beginning here contain the same information 


that they held when the job issued the .RUN, .CHAIN, or .CCL 
directive. 
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Mne- Octal 


monic Offset 


FIRQB on P.RUN Entry 


Octal Mne- 
Offset monic 


tere eee ee ee eee ee ee eee perenne eee eee eee eee eee + 
i AAA A hhh 
Herter re ee ee ee ee ween pete ee eee eee ee ee eee + 
3 POL eee) job number * 2 | 2 FQJOB 
ees es= se we eww ww wee ww ew we we we eee er we ee hh Hh hl Oh ee ee + 


5 WLLL 4 


7 i project number ] programmer number i 6 FQPPN 
tee eee ee eee ee ee eee eee tener ee eee eee ee ee eee + 
11 | file name in RAD50 format | 10 FQNAM1 
| (2 words) | 
13 | | 12 
t-- ee ee eee ee eee ee eee per ene eee eee eee ee eee + 
15 | file type in RAD50 format (1 word) | 14 FQEXT 
tee eee ee eee ee ee ee eee tere ee ee eee eee ee ee eee + 
17 | file size in 512-byte bleexa | 16 FQSIZ 
terete eee ee eee ee eee eee Henne eee eee eee ee ee eee + 
21 | default buffer size for disk | 20 FQBUFL 
tee ee ee ee eee ee eee eee tee eee ee eee eee eee eee + 
23 Uae 22 
terre er ee eee ee eee eee Se + 
25° | device description | 24 FQFLAG 
tenn ree ee eee eee eee eee teen ee ee eee eee ee ee eee + 
FQPROT 27 | ' protection code | cluster size | 26 FQPFLG 
t--- eee ee eee eee eee eee tere ee eee ee eee ee ee eee + 
31-1 device name (2 ASCII characters) | 30 FQDEV 
tere ee eee eee eee eee eee +----- eee were ee ee eee + 
33 | flag byte | device unit number | 32 FQDEVN 
er tere ee ee eee ee ee eee eee + 
35 | file identification index | 34 FQCLUS 
i tener ee eee ee ee ee ee eee + 
37 | entry parameter | 36 FQNENT 
tener eee ee eee eee eee teen eee ee ee ee eee eee + 
FIRQB+FQJOB The job number (assigned by the monitor when this 
job was created) times two. 
FIRQB+FQPPN The project-programmer number for the file that is 
to be run. 
FIRQB+FQNAM1 The name of the file that is to be run, as two 
words in RAD50 format. 
FIRQB+FQEXT The type of the file that is to be run, as one 
word in RADS50O format. 
FIRQB+FQSIZ The file size, in 512-byte blocks. 
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FIRQB+FQFLAG 


FIRQB+FQPROT-1 


FIRQB+FQPROT 


FIRQB+FQDEV 


FIRQOB+FQDEVN 


FIRQB+FQDEVN+1 


FIRQB+FQCLUS 
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The recommended size, in bytes, for the buffer 
size ina .READ directive for this file. 


Flag bits defining the device. They are set to 
indicate that this is a disk file. (See the 
FQFLAG description in the open function of the 
CALFIP directive.) 


The file cluster size, modulo 256. (That is, a 
file cluster size of 256 is indicated by a zero 
byte here.) This byte is the same as the FQCLUS 
value supplied in the open functions of the CALFIP 
directive, except that it is returned in a byte 
instead of a word. 


The protection code of the file. 


The device name of the disk device, as two ASCII 
characters. 


The unit number of the disk device. 
The low-order two bits of this byte are set to 


indicate whether or not the device is part of the 
public structure: 


Bit 0 = 0 The device is in the public structure. 
= ] The device is a private disk. 
Bit 1 = 0 A specific device was not specified in 


the open function. 
= ] A specific device was specified in the 
open function. 


The file identification index of this file. This 
word is significant in that you can use it in 
place of the file name in subsequent opens of the 
file on disk. You can open the file with the 
OPNFQ subfunction of CALFIP, using: 

o An explicit PPN in FIRQB+FQPPN 

o A zero word in FIRQB+FQNAM1 

o An explicit device name in FQDEV and FQDEVN 


o The file identification index in 
FIRQB+FQNAM1+2. 
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FIRQB+FQNENT 


Parameter word from the caller. The .RUN or 
.CHAIN directive, which causes entry at P.RUN ina 
run-time system, allows the caller to specify a 
parameter word to be passed to the run-time 
system. Bit 15 of this word may or may not be the 
same as the caller passed, however. If the .RUN 
or .CHAIN directive was issued from a privileged 
program with temporary privileges enabled, bit 15 
is passed by the caller. Otherwise, bit 15 is 
cleared. 


For .CCL entries, bit 15 is set by the monitor. 
If the CCL definition for the CCL being executed 
has the /PRIVILEGED qualifier included in it, the 
bit 15 is set; otherwise, it is cleared. 


PART Il 
Monitor 
Directives 


Chapter 3: General Monitor Directives 


Introduction 


This chapter describes the general directives to the RSTS/E monitor. 
These directives are available to the MACRO programmer under both the 
RSX and RT11l run-time systems. They are Emulator Trap (EMT) 
instructions that are processed directly by the monitor. A run-time 
system does not examine or process these general directives. 


Summary of General Monitor Directives 


Table 3-1 summarizes the general monitor directives. Detailed 

' Gescriptions are given in the sections that follow this introductory 
Material. The descriptions are arranged alphabetically by mnemonic 
name. 


Some directives, which cause a change in run-time system or change in 
job size, should not be executed by a program (user job image) running 
under the RT11 run-time system, or unpredictable results may occur. 
These directives are marked with an asterisk (*) in Table 3-l. (Note, 
however, that these are not restrictions for assembling using MACRO -- 
the assembler for the RT1l1l run-time system. If you are coding a 
run-time system, you use these directives and assemble under either 
MACRO or MAC.) 


Table 3-l: Summary of General Monitor Calls 


+----- ee eee +---- +--+ per ee ee ee ee ee ee ee eee + 
| | EMT | | 
| Code | | 
| Name (Octal) | Description | 
tee - eee eee t--- eee ee pr ee ee ee ee ee eee + 
CALFIP | 0 Call the File Processor portion of the RSTS/E 


monitor. Includes "housekeeping" functions 
for file/device I/O such as OPEN, CLOSE. 


| | 

| | 

| | 

| | 

| | 

READ | 2 | Read from a previously opened file or device. | 

| | 

WRITE 4 | Write to a previously opened file or device. | 

| | | 
CORE* 6 | Change memory size allocated for user job 

| | image. | 

| | | | 
- SLEEP | 10 | Sleep job for n seconds. | 

| | | 

| «PEEK | 12 | Peek at the monitor’s memory. | 
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Table 3-1: Summary of General Monitor Calls (Cont.) 


| tree cee eee He ee ee ee ee ee eee ee eee eee eee 
| | EMT | 
| | Code | 
Name | (Octal) | Description 
terre ee eee re Hr er ee ee ee ee ee ee ee ee ee eee eee 
| SPEC : 14 | Special function. 
: TTAPE : 16 | Enter tape mode. 
| TTECH | 20 : Enable echo on a channel. 
: . TTNCH : 22 : Disable echo on a channel. 
: TTDDT : 24 : Enter ODT submode on a channel. 
: TTRST : 26 : Cancel CTRL/O effect. 
: TIME : 30 | Get timing information. 
: POSTN | 32 | Get device’s horizontal position. 
: DATE | 34 : Get current date. 
: SET : 36 : Set keyword bits. 
| . STAT : 40 : Get statistics for job. 
: RUN* : 42 | Run new program (user job image). 
| NAME : 44 : Install a new program name. 
| EXIT* , 46 | Exit to default keyboard monitor. 
: RTS* : 50 | Switch to new run-time system. 
: - ERLOG : 52 ! Log an error from run-time system. 
| . LOGS : 54 : Check for logical devices. 
: CLEAR : 56 | Clear keyword bits. 
| . MESAG | 60 | Message send/receive. 
: CCL* | 62 : Check string to see if Concise Command 
| | | Language (CCL). 
.FSS* 64 | Scan a string for valid RSTS/E file 
| 


specifications. 
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Table 3-1: Summary of General Monitor Calls (Cont.) 


terse eee ee te -- ee eee te - ee ee ee ee ee ee ee ee ee ee eee + 
| | EMT | | 
| | Code | | 
| Name | (Octal) | Description 

tee e ee ee eee tere eee eee ter ee ee ee ee ee ee ee ee ee eee eee + 
| | | | 
| .UUO | 66 Execute monitor FIP call (access to 

| | BASIC-PLUS SYS calls to FIP). 

| | | 
| .~CHAIN** | 70 Execute user job image under same run-time | 
| | system. | 
| | | 
| .PLAS | 72 Access a Shared library. 

| | | 
| .ULOG | 76 Assign/reassign/deassign device or user 
| | logical. 

| | | | | 
| .READA | 102 | Asynchronous read. | 
| | | | 
| .WRITA | 104 | Asynchronous write. 
| | | | 
| .ASTX | 106 | AST exit. | 
| | | | 
| .CMDLN | 112 | Read/write command line buffer. 

| | | | 
| .AST | 114 | AST enable/disable. | 


x This directive should not be used by a program running under 
control of either the RT11 run-time system or the RSX emulator. 


xx These directives should not be used by a program running under 
control of the RT11 run-time system. 


Prefix File COMMON.MAC 


The monitor directives that this chapter describes require that you 
pass parameters to the monitor in the FIRQB and XRB; values are also 
returned to your program in these areas. The file COMMON.MAC, 
provided with all RSTS/E kits, relates mnemonics to often-used 
addresses, offset values, and function codes, eliminating the need for 
octal coding and addressing. These mnemonics are used in the 
directive descriptions that follow; DIGITAL recommends their use for 
readable, maintainable code. 


How to Assemble with COMMON.MAC 


COMMON.MAC is a prefix file; it is assembled with your other MACRO 
source files under either the RSX or RT1ll run-time systems. For 
example, under the RTll run-time system, the following sequence would 
assemble the files COMMON.MAC, SRC1.MAC, and SRC2.MAC into the object 
module file OBJ.OBJ with an assembly listing file OBJ.LST: 


RUN SMACRO 
*OBJ ,OBJ=COMMON,SRC1,SRC2 


Similarly, under the RSX run-time system, this sequence would assemble 
the files COMMON.MAC, SRC1.MAC, and SCR2.MAC into the object module 
file OBJ.OBJ with an assembly listing file OBJ.LST: 


RUN SMAC 
MAC>OBJ ,OBJ=COMMON,SRC1,SRC2 


Macros Provided in COMMON.MAC 


In addition to providing mnemonics, the COMMON.MAC file contains 
macros that can be used in programs assembled under either the RSX or 
RT11 run-time systems, as long as COMMON.MAC is assembled with the 
source, as described previously. These macros are: 


TITLE name,desc,nn,date,editors 


The TITLE macro sets a title ({.TITLE) from the name and 
description (desc) parameters and builds an 
identification (.IDENT) from the specified number nn. 
The IDENT has the form xx.xnn, where xx.x is the 
current RSTS/E version number (09.0 for v9.0), and nn 
is the edit level you specify. Descriptive information 
is placed in the table of contents as follows: 


EDIT: DATE: BY: 
nn date editors 
ORG section[,offset] 


ORG defines the origin address of a program section. 
The first occurrence of an ORG with a given section 
name causes all instructions requiring memory space 
following the ORG to be assigned consecutive 
relocatable addresses starting with zero or, if an 
offset is given, with the octal address given. 
Following occurrences of an ORG with the same section 
name causes resumption of addressing wherever it left 
off before, because of an intervening ORG. 
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DEFORG 


TMPORG 


UNORG 


INCLUDE 


-DSECT 
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The ORG macro also defines a symbol with the same name 
as the section at the first relative location within 
the section. Every invocation of ORG also defines (or 
redefines) the section to be returned to by the macro 
UNORG. 


section 


The DEFORG macro is the same as the ORG macro except 
that the symbol at relative 0 (the section name) is 
declared as a global symbol. By convention, the module 
that defines the section (rather than just uses it) 
issues the DEFORG macro. 


section[ ,offset] 


TMPORG is the same as ORG except that it does not 
define (or redefine) the section to be reentered by the 
UNORG macro. In this way, the module can temporarily 
enter a new section and then return to the main section 
using UNORG without having to know the main section 
name. 


The UNORG macro will reenter the section most recently 
declared in an ORG or DEFORG macro. 


namel[{,name2,...] 


The INCLUDE macro indicates that the module issuing the 
INCLUDE requires the named modules (namel, ...). The 
name(s) should be declared with DEFORG(s) in the 
required modules. 


INCLUDE declares the listed section names as global 
symbols and issues the macro directive .SBTTL with the 
heading "INCLUDE FROM LIBRARY ‘'name’" to be inserted in 
the assembly listing table of contents. INCLUDE 
documents the named sections as required by this 
section. 


[start])[,cref] 


The .DSECT macro starts a dummy program section (with 
the MACRO directive .ASECT) at relocatable address 0 or 
at the address given by the optional argument start. 

If the cross-reference (cref) parameter is given 
(nonblank), the program section is included in the 
cross-reference listing, if you request one for the 
assembly. 


The .DSECT macro is used in the file COMMON.MAC to 
define the system parameters and offsets. 
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-BSECT 


- EQUATE 


For example, coding of this form is used in COMMON.MAC 
to assign the proper values to the mnemonics in the 
pseudo-vector region: 


-DSECT 177776,NOCREF 
- BLKW -1 
P.SIZE: - BLKW -1 
P..2CC: - BLKW -1 
P.CCs . BLKW -l 


Note 


A .DSECT is used at the end of the file 
COMMON.MAC. This means that you must 
explicitly start your MACRO program with an ‘ORG 
macro or .PSECT directive to begin your program 
at relocatable address 0. Otherwise, your code 
will be regarded as a continuation of the 
-DSECT, and the program will not assemble 
properly. 


{[HIGH}][,cref] 


The .BSECT macro is like the .DSECT macro except that 
the default starting address is 1 instead of 0. If the 
argument HIGH is used, the starting address is 400 
(octal). This starting address lets you use .BSECT to 
generate bit values. The .BSECT macro is used in 
COMMON.MAC to define mnemonics for bit locations. For 
example, the following coding assigns the mnemonics to 
the bit locations in the keyword (KEY; see Chapter 2). 
Note that the period (.) after .BLKB is required. 


-BSECT HIGH,NOCREF 
JFSPR1: - BLKB . 
JFPP: - BLKB s 


symbol,value 


»-EQUATE defines the given symbol to have the supplied 
value (which may be an expression) by using the 
equivalent of: 


-DSECT value 
-symbol: 
UNORG 


4 


» BLKWO 


» BLKBO 


GLOBAL 


RETURN 


JMPX 


CALL 


CALLR 


CALLX 
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[amount][,value] 


The .BLKWO macro is similar to the MACRO directive 
-BLKW, which reserves a specified number of words of 
storage space. The amount can be any expression, the 
default is one. While .BLKW just reserves space, 
~-BLKWO fills the space with the value you specify; the 
default is zero. 


[amount][,value] 


The .BLKBO macro is similar to the MACRO directive 
-BLKB, which reserves a specified number of bytes of 
storage space. The amount can be any expression, the 
default is one. .BLKBO fills the space with the value 
you specify; the default is zero. 


<namel[,name2,...]> 


GLOBAL declares the name symbols as external global 
symbols. 


[register] 

The RETURN macro generates an RTS PC by default but can 
generate any other RTS instruction if you specify an 
explicit register. 


label 


JMPX is just like the JMP instruction but will also 
Geclare the label to be an external global (that is, 
jump external). 


subroutine[,register[,argument list] ] 

You can use CALL instead of JSR PC to call subroutines. 
If an explicit register is specified, then the call is 
JSR using that register. If an argument list is 
specified, it generates a list of .WORD arguments in 
line with the subroutine call. 

subroutine 

CALLR is equivalent to a CALL to a subroutine 
immediately followed by a RETURN. CALLR generates a 
JMP instruction. 


subroutine 


CALLX is just like CALL, but it also declares the 
subroutine name as an external global symbol. 
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CALLRX subroutine 


CALLRX is just like CALLR except that the subroutine 
name is declared as an external global symbol. 


Error Mnemonics: Symbol Table File ERR.STB 


When the monitor processes the directives that this chapter describes, 
any errors that it detects are passed back to the job in the first 
byte of the FIRQB as a binary value. The ERR.STB file, provided with 
all RSTS/E kits, relates mnemonic values to these binary codes, so you 
do not have to analyze and process errors in octal. The descriptions 
in this chapter all refer to the mnemonics provided by ERR.STB. See 
Appendix A for a list of all possible errors. 


The symbols are automatically resolved at link time if you include 
ERR.STB with the files you link with either TKB (the Task Builder for 
the RSX run-time system) or LINK (the linker for the RT1l1 run-time 
system). For example, under the RSX run-time system, the following 
code links ERR.STB and MAIN.OBJ to produce the executable file 
IMG1.TSK, a memory allocation file MP1.MAP, and a symbol definition 
file SF1.STB: 


RUN STKB 
TKB>IMG1,MP1,SF1=ERR.STB,MAIN 


Similarly, under the RT1ll run-time system, the following sequence 
links ERR.STB and MAIN.OBJ to produce the executable file IMG1.SAV, a 
memory allocation file MP1.MAP, and a symbol definition file SF1.STB: 


RUN SLINK 
*IMG1,MP1,SF1=ERR.STB,MAIN 


Programming Hints 


Preset the FIRQB and XRB to Zero 


The monitor directives in this chapter pass information to the monitor 
in the FIRQB and XRB areas of the low 512. bytes of memory. It is 
usually a good idea to clear the entire FIRQB and XRB before issuing a 
call, to ensure that no extraneous information (for example, from data 
returned on a call) has been left in the areas that could affect how 
the call executes. 


In some cases, however, you may want to leave the FIRQB and XRB alone. 
The .FSS call, for example, scans a string and, if it is a valid file 
specification, returns to the FIRQB the information needed to open the 
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file with the CALFIP call. You do not want to clear the FIRQB before 
opening the file with CALFIP. 


Note 
To ensure compatibility with future releases of 
RSTS/E, you should always set to zero any fields in 
the FIRQB and XRB diagrams that are shaded or are 
documented as reserved or not used. 


The following example contains three routines that clear the FIRQB and 
XRB: 


CLRFQOX Clears both the FIRQB and XRB. 
 CLRFQB Clears the FIROQB. 
CLRXRB Clears the XRB. 


The values FQBSIZ and XRBSIZ used in these routines are defined in 
COMMON .MAC. 


-ENABL LSB 


CLRFQX:: PUSH <RO,R1> ;Save RO,R1 
MOV #FIRQB,RO Point to FIRQB. 
MOV #<<FQBSIZ+XRBSIZ>/2>,R1 ;Compute how many words 
BR 10$ ;to clear. 
CLRFQB:: PUSH <RO,R1> ;Save RO,R1 
MOV #FIRQB,RO ;Point to FIRQB. 
MOV #<FQBSIZ/2>,R1 ;Compute how many words 
BR 10$ ;to clear. 
CLRXRB:: PUSH <RO,RI1> s;Save RO,R1 
MOV #XRB, RO ;Point to XRB 
MOV #<XRBSIZ/2>,R1 ;Compute how many words 
;to clear. 
10S: CLR (RO)+ :;Zero it out ... 
SOB R1,10$ ;’til all done 
POP <R1,RO> ;Restore RO,RI1. 
RETURN 
-DSABL LSB 
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Data Returned to FIRQB and XRB 


If a call completes without error, the monitor sets byte 0 of the 
FIROB to zero. If an error occurs on a call, the monitor sets byte 0 
of the FIRQB to an error code. Likewise, the monitor always sets the 
byte at FIRQB+2 to the current job number times two when a call 
completes. 


In some circumstances, it may be useful to know what happens to the 
passed-data when a call completes. For instance, is the file name 
still there? Bytes not specified as containing returned-data are 
undefined. Do not rely on these values when coding your programs 
because DIGITAL reserves the right to change the values returned in 
these bytes at any time. In addition, if an error occurs, the data 
returned may or may not have replaced the data passed. It depends on 
how far processing for the call got before the error occurred. 


Channel Numbers for I/0 


Directives that handle I/O use a channel number to refer to a device. 
In device or file opens, a channel number is related to a specific 
device defined in the call. Directives that transfer data (.READ, 
-WRITE, .READA, .WRITA) can then refer to a channel number rather than 
define a device or file. 


Valid channel numbers range from 0 through 17. Channel 0 is the job’s 
terminal; for example, a .WRITE to channel 0 writes to the terminal 
which is running the job. Channel 0 is always open. Similarly, the 
monitor opens a file to be run on channel 17 when control transfers to 
the P.RUN entry point in a run-time system. Thus, user jobs may 
define and use channels 1 to 16. 


Directives That Do I/0 


The CALFIP subfunctions OPNFQ, CREFQ, CRBFQ, and CRTFQ open a file or 
device and relate the specified channel number to that file or device: 


o OPNFQ opens a file or device for input 


o CREFQ creates a file, that is, opens a file or device for 
output 


© CRBFQ creates a binary (executable) output file on disk 
o CRTFQ creates a temporary file on disk 


The directives .READ and .WRITE transfer data between memory and a 
device or file specified by channel number. 


The CLSFQ (close) and RSTFQ (reset) subfunctions of CALFIP close a 
device or file and free the associated channel number so it can be 
used with another device or file. 


3-10 


General Monitor Directives 


' Directives That Support I/0 


The file string scan (.FSS) directive is useful for programs that 
process files specified by a terminal user. The .FSS directive 
examines a string of characters and, if it is a valid RSTS/E file 
specification, converts it to the FIRQB format used to open a file. 
Thus, your program can accept a typed string from the job’s terminal 
and use .FSS to convert the string to the FIRQB format to do I/0 on 
the file. 


You can use the LOKFQ subfunction of CALFIP to search for disk files 
that meet wildcard file specifications. For example, you could search 
an account on disk for all files with names beginning with the 
characters DD. 


-AST 


-AST -- Enable/Disable AST Delivery 
Form 

-AST 
Function 
The .AST directive has two functions: disable AST delivery and enable 
AST delivery. The .AST disable function stalls all AST deliveries 
from the monitor until the user explicitly enables them with the .AST 
enable directive. 
Privileges Required 
None 


Data Passed 


The only data passed for this directive is the byte 0 of the FIRQB. 
If zero, enable AST deliveries. If minus one, disable AST deliveries. 


Data Returned 


Except for a possible error code in byte 0 of the FIRQB, this 
directive does not return any meaningful data. 


Errors 


BADFUO Illegal function code. 


e-ASTX 


~ASTX - Exit from AST Routine 
Form 

~-ASTX 
Function 


The .ASTX directive is similar to a RETURN in a normal subroutine. It 
instructs the monitor that the asynchronous routine has completed and 
that control should return to the job at the point it was interrupted. 
All AST routines must finish with a .ASTX directive. 


When an AST routine issues the .ASTX directive, the PSW previously 
stored on the user’s stack is validated. The PSW is forced into the 
standard mode (previous user/current user mode, register set l, and 
priority 0). The PC and PSW are then used to return control to the 
program at the point where it was interrupted. 


The XRB and bytes 0, 6, and 7 of the FIRQB are restored. If the user 
has altered the PC, PSW, or destroyed the stack contents, no specific 
error is returned. Instead, bad PC and/or stack causes fatal errors 
which are handled in the usual way (entry to P.BAD in the RTS). 


To make sure this directive behaves correctly, the AST routine must 
make sure all general registers (RO to R5) and the stack pointer have 
the same contents as on entry to the AST routine. In addition, if any 
part of the FIRQB other than bytes 0, 6, and 7 has been used, the AST 
routine must restore the contents of the FIRQB to what it had on 
entry. Failure to observe these rules may produce unexpected results. 
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CALFIP - Call the File Processor 


Form 


CALFIP 


Function 


The CALFIP directive to the RSTS/E monitor handles housekeeping 
necessary for input/output on RSTS/E. For example, CALFIP lets you 
open a channel for file or device I/0. 


You select the particular function by setting a function field in the 


FIRQB (at offset FQFUN). Other parameters are also passed to the 
monitor in the FIRQB, depending on the function requested. 


Table 3-2 lists the CALFIP subfunctions by function code. The 
sections following Table 3-2 describe the subfunctions in alphabetical 
order. 


Table 3-23 


Summary of CALFIP Subfunctions 


es eweeeeseewe ere =F Feeeewereeewseeewreereeswseeweeeeeweeeereewreeerwreeesese = 


Close an open channel (CLOSE) 

Open a channel (OPEN FOR INPUT) 
Create/extend a file (file-structured OPEN 
FOR OUTPUT) 

Delete a file by name (KILL) 

Rename a file (NAME...AS) 

Get directory information 

Process UUO 

Get error message text 

Reset (close) a channel or all channels 
(except channel 0) 

Look up a file 

Allocate a device 

Deallocate a device 

Deallocate all devices 

Create/fextend a temporary file on disk 
Create/fextend a compiled image file on disk 
(file-structured OPEN FOR OUTPUT, protection 
code bit 6 always set) 


CALFIP 
ASSFQ 
i ASSFQ (Allocate a Device) 
Form 


MOVB #ASSFQ,FIRQB+FQFUN 


(Set up FIRQB to define device) 


CALFIP 
Function 


~The ASSFQ subfunction reserves a physical device for a job or 
transfers assignment of a currently owned device to another job. 


Privileges Required 
DEVICE to allocate a device for the current job if the requested 


device is restricted. HWCTL to seize a device or reallocate a device 
to a job in another account. 


CALFIP 
ASSFQ 


Data Passed 
Mne- Octal Octal Mne- 
monic Offset Offset monic 


1 EO ee a 0 
FQFUN 3 | ASSFQ (= 24) WLLL 2 


VL |SSSSSAIS1111111//////\ =9,assign;40,job no.| 10 FQNAMI 


15 | DOS or ANS (1 word EADS 0} or 0 (magtape) | 14 FQEXT 


23 |100001 for snagging assign/reassign; else 0| 22 FQMODE 


Si. device name (2 ASCII characters) | 30 FQDEV 
Se tener ee eee ee ee ee ee eee + 
33 | #0, unit no. real | device unit number | 32 FQDEVN 


37 VL 36 


FIRQB+FQFUN The function code ASSFQ (octal value = 24). 


FIRQB+FQNAMI1 This byte is set to zero to indicate an assign; if 
nonzero, it is used as the job number to which the 
device is to be reassigned. The high byte of this word 
(FIRQOB+11) must be set to zero. 


If you do not have HWCTL privilege, you can reassign a 
device only to a job that is logged in to the same 
account as your current account. 


CALFIP 
ASSFQ 


FIRQB+FQEXT When the device is magnetic tape, this word can contain 
either DOS or ANS in RAD50 format, to indicate DOS or 
ANSI label format for the tape drive. It can also be 
set to zero to indicate the system default for the 
drive. 


FIRQB+FQMODE This word is set to 100001 to assign a device that is 
currently assigned to another user. This is a snagging 
assign and is available only to users with HWCTL 
privilege. If you do not want a snagging assign, this 
word must be zero. 

FIRQB+FQDEV Device name, as two ASCII characters. 

FIRQB+FQDEVN The device unit number is passed here in binary. A 

nonzero value in FIRQB+FQDEVN+1 indicates an explicit 
device unit number. A zero value in FIRQB+FQDEVN+1 
indicates no unit number. 

Data Returned 


Other than a possible error code in byte 0 of the FIRQB, the ASSFQ 
subfunction returns the previous owner of the device in FIRQB+FQFIL. 


Errors 
For Assign (byte at FIRQB+FQNAM] = 0): 


NODEVC The device name specified at FIRQB+FQDEV is not a valid 
device name. 


NOTAVL The device and unit specified exists on the system, but 
the attempt to reserve it is prohibited because: 


o The device is currently reserved by another job. 


o The device or its controller has been disabled by 
the system manager. 


o The device is a keyboard line for a pseudo keyboard 
only. 


PRVIOL The device requires DEVICE privilege to allocate. 


CALFIP 
ASSFQ 


For Reassign (byte at FIRQB+FQNAM1 # 0): 


BDNERR The job number specified does not exist. 

INUSE The device specified is currently open or has an open 
file. 

NODEVC The device name is a logical device name for which a 


physical device is not currently assigned. 

NOTAVL (See previous description for Assign.) 

PRVIOL You do not have HWCTL privilege and you tried to 
reallocate a device to a job that is logged in to an 
account other than your current account. 


Example 


The following code reassigns magnetic tape unit 0 (MT0O:) to job 12: 


MAGT: ASCII /MT/ 
CALL CLRFQB ;CALL ROUTINE TO CLEAR FIRQB 
MOVB #ASSFQ, FIRQB+FQFUN ;SET FUNCTION CODE 
MOVB #12.,FIRQB+FQNAM1 ;ASSIGN TO JOB 12 
MOV #° RANS, FIRQB+14 ;ANSI-LABEL TAPE 
MOV MAGT, FIROB+FQDEV ;MAGTAPE DEVICE 
CLRB FIRQB+FQDEVN ;UNIT NO. 0 
MOVB #377,FIRQB+FQDEVN+1 ;UNIT NO. REAL 
CALFIP 
TSTB FIRQB ;ANY ERRORS? 
BNE ERRTN ;BRANCH TO PROCESS ERROR 


See Programming Hints for information on the CLRFQB routine. 


CALFIP 
CLSFQ 


CLSFQ (Close a Channel) 


Form/Example 
CHANO=8. ; Set value for channel 
MOVB #CLSFQ, FIRQB+FQFUN ; Set function code in FIRQB 
MOVB #CHANO*2,FIRQB+FOFIL > Set channel 8 for CLOSE 
CALFIP s Execute monitor directive 
Function 


The CLSFQ function closes a channel. The specific action taken 
depends on the device or file that was previously opened on the 
channel and whether it was opened for input or output, as well as the 
mode with which it was opened. For example, closing a channel on 
which a magnetic tape was opened for input in file-structured mode 
causes the monitor to position the tape at the end-of-file (EOF). See 
the RSTS/E Programming Manual for a description of the actions taken 
on closing various devices/files. 


Requesting CLSFQ for a channel that is not currently open returns with 
no action taken and no error is indicated. 


Privileges Required 


None 


CALFIP 
CLSFQ 


Data Passed 

Mne- Octal Octal Mne- 

monic Offset Offset monic 
1 Ph EERE AEN ef AA MELEE 0 

FQFUN a CLSFQ (= 0) VWPLILSPPISSPISSAILLT 2 


Henn ree eee ee ee eee pec n nee ee ee ee eee eee eee + 
S ISAASSIIAIS1A11116007C7 | channel no. * 2 | 4 FQFIL 


FIRQB+FQFUN The function code CLSFQ (octal value = 0). 


FIRQB+FQFIL Channel number times two; defines the channel to be 
closed. 


Data Returned 


Except for a possible error in byte 0 of the FIRQB, the CLSFQ function 
of CALFIP does not return any meaningful data. 


CALFIP 
CLSFQ 


Errors 


All errors with the CLSFQ function of CALFIP are device- dependent. 
See Appendix A for a full list of errors. 


Example 


The following MACRO code closes the file or device on channel 12: 


CALL CLRFQB ;CLEAR FIRQB 

MOVB #CLSFQ, FIRQB+FQFUN ;SET FUNCTION CODE IN FIRQB 
MOVB #12.*2,FIRQB+FQFIL ;SET CHANNEL 12 FOR CLOSE 
CALFIP ;EXECUTE MONITOR DIRECTIVE 
TSTB FIRQB ;TEST BYTE Q FOR ERROR 

BNE ERRTN ;BRANCH TO PROCESS ERROR 


See Programming Hints for information on the CLRFQB routine. 


CALFIP 
CRBFQ 
CRBFQ (Create a Binary [Executable] File and Open It on a Channel) 
Form 
MOVB #CRBFQ, FIRQB+FQFUN ;SET FUNCTION CODE 


(Set parameters in FIRQB appropriate to device) 


CALFIP 
Function 


The CRBFQ function creates and opens a binary (executable) file. It 
is identical to the CREFQ function, except that the protection code is 
automatically set to indicate an executable file, and the file must be 
opened on a disk device. 


Privileges Required 


TUNE to set caching mode. SYSIO to set the privileged-program bit 
(bit 7 in FQPROT). A matching PPN, GWRITE, or WWRITE, and/or SYSIO to 
create or rename a file. You also need write access (by protection 
code, GWRITE, WWRITE, and/or SYSIO) to supersede an existing file. 


Data Passed 


CALFIP 
CRBFQ 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Here ee ee ee eee ee eee tere ee eee eee eee eee eee + 
LYSSSSISIIISIIIISLAA SSAA AAAI AAAI ASA AAA A617 \ 98 
5 tee eee ee ee ee eee + 
FQFUN 3 | CRBFQ (= 34) UA She A LAS EAA SARA EE DS 2 
ee Se a ee 
FOSIZM 5 | (must = 0) i channel no. * 2 H 4 FQFIL 
St Sr + 
7 | project number | programmer number | 6 FQPPN 
t---- ee ee eee ee ee eee eee Heer ee er ee ee eee eee eee + 
11 | file name in RAD50 format | 10 FQNAMI1 
+ + 
13 | (2 words) | 12 
terre ee eee ee eee St + 
Lo file type in RAD50 format (1 word) | 14 FQEXT 
Sr ten ee ee eee ee ee eee eee + 
17 | (file size in ae -byte blocks) | 16 FQSIZ 
Se + 
21  LPILLILL ILA LLALLL DLAI APAPPALPAEL TLL LD TE 20 
Se +---- ee ee eee eee eee eee + 
23°.) mode | 22 FQMODE 
tener ee eee ee eee eeeeee tee - eee eee ee eee ee eee + 
25 SASSI IIITSIIIAL ASSIS AAA AAA AAA AAA AAAS AS17124 
terete eee ee ee ee ee eee t---- eee eee ee ee ee eee + 
FQPROT 27 | file protection | #0, prot.code.real | 26 FQPFLG 
Se tee ee eee eee ee ee eee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
tenner ee eee eee eee eee tee ee ee eee ee ee eee eee + 
33 | #0, unit no. real | device unit number | 32 FQDEVN 
Se t----- eee eee eee eee eee + 
35 | file clustersize | 34 FQCLUS 
+------- eee eee ee eee eee terre eee ee ee ee ee eee + 
Sr (| device cluster number for first block | 36 FQNENT 
tere ee ree eee ee ee ee eee terre eee eee eee eee eee + 
FIRQB+FQFUN The function code CRBFQ (octal value = 34). 
FIRQB+FQFIL Channel number times two; defines the channel upon 
which the file is to be opened. 
FIRQB+FQSIZM On other types of create opens, this byte contains the 
most significant bits (MSB) of the file size. 
Executable (binary) files cannot be greater than 65,535 
blocks so this byte must always be passed as zero. 
FIRQOB+FQPPN The PPN with which the file is to be created. The 


project number is in the high byte (FQPPN+1) and the 
programmer number in the low byte (FQPPN). A value of 
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FIRQB+FQNAM1L 
FIRQB+FQEXT 


FIRQB+FQSIZ 


FIRQB+FQMODE 


FIROB+FQPROT 


FIRQB+FQDEV 


FIRQOB+FQDEVN 


FIROB+FQCLUS 


FIRQB+FOQNENT 


zero in both bytes defaults to the PPN under which the 
calling program is running. 


The file name created, as two words of RAD50 data. 
The file type, as one word of RAD50 data. 


The desired file size, in 512-byte blocks. The file is 
preextended to the specified size; that is, the space 
for the file is allocated when the file is opened, 
rather than as it is written. 


The mode with which the file is to be opened; values 
and actions taken are as described for the MODE 
modifier in file-structured OPEN FOR OUTPUT statements 
for disk, as the RSTS/E Programming Manual describes. 
If a mode value is used, bit 15 of this word must be 
set to l. 


File protection code; values for this field define 
read/write and execute access to the created file (see 
the RSTS/E System User’s Guide). If you want a default 
protection code, then set a full word of zeros at 
FIRQB+FQPFLG. In this case, either the system default 
for protection code will be used, or, if the CRBFQ will 
be deleting a previously existing file with the same 
file name, type, PPN, and device, the file protection 
code of the previously existing file will be used. 


To assign a specific file protection code, a nonzero 
value is passed in byte FIRQB+FQPFLG (by convention, 
255) and the specific file protection code in byte 
FIRQB+FQPROT. Bit 6 is automatically set, indicating 
that the file is executable. The RSTS/E System User’s 
Guide describes the protection codes for executable 
files. 


The device name is passed here as two ASCII characters; 
it must be a disk device. If this word is zero, the 
public disk structure is assumed. 


The device unit number is passed here in binary. A 
nonzero value in FQDEVN+1 indicates an explicit device 
unit number. A zero value in FQDEVN+1 indicates no 
unit number. 


This parameter has the same function as the CLUSTERSIZE 
option in BASIC-PLUS. The BASIC-PLUS Language Manual 
describes the CLUSTERSIZE option for disks. 


Device cluster number for placement of block 1 of the 
file. When you are creating a new file, you can place 
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block 1 of the file on a particular block by specifying 
the disk device cluster number in this word. If this 
word is zero, no placement is done. If it is nonzero, 
the monitor will try to place the file at the specified 
device cluster or as near after it as possible. If the 
first block of the file can be placed at or after the 
specified device cluster number, the monitor sets a bit 
in the file’s entry in the User File Directory (UFD). 
If the first block of the file cannot be placed at or 
after the specified device cluster number, the file is 
placed at the lowest free block on the disk, the bit in 
the file’s entry in the UFD is not set, and no error is 
returned. 


A value of -1 specifies the center of the disk; a value 
of -2 means immediately after the directory. 
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Data Returned 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terete eer eee eee eee eee terre eee ee ee ee eee eee + 
1 LED ad dete MOLI ARAMA MARA See 0 
ie i + 
3 yyy current job no. * 2 | 2 FQJOB 
tern n re ee eee eee eee terre re eee eee eee + 
FQSIZM 5 | (always 0) | channel number * 2 | 4 FQFIL 
torre ee ee eee eee tee ee ee ee ee eee eee + 
7. | project number | programmer number | 6 FQPPN 
Henn ee ee ee eee terre eee ee ee er ee ee eee + 
ll | file name in RAD50 format | 10 FQNAM1 
+ + 
13... | (2 words) | 12 
terre ee eee ee ee eee eee tee eee ee ee ee eee eee + 
LS. | file type in RAD50 format (1 word) | 14 FQEXT 
t---- ee ee re eee eee eee +--- eee ee ee eee eee eee + 
Ly: | (file size in 512-byte blocks | 16 FQSIZ 
torre er eee ee eee eee tee ee eee ee eee eee + 
21 | reasonable buffer size for Autos | 20 FQBUFL 
tee eee eee ee eee eee ee eee +--------- eee meee ee eee + 
23 | (as passed) | 22 FQMODE 
terre eer re eee eee t-- eee e eee ween eee + 
25: device description | 24 FQFLAG 
Se tee eee eee ee eee ree + 
FQPROT 27 | protection code | eustereive: mod256 | 26 FQPFLG 
tee eee ee eee ee eee eee te ee re ee ee ee eee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
torre re ee eee eee t--- ee eee ee eee + 
33 | flag byte | device unit number | 32 FQDEVN 
tere ee eee eee ee eee eee tener ee te ee ee ee eee + 
35. | file identification index | 34 FQCLUS 
tern eee ee eee eee ten eee ee ee ee eee eee + 
37 | (as passed) | 36 FQNENT 
tere ee ee ee eee eee teeter ee ee ee eee eee + 
FIRQB+FQJOB Current job number times two. 
FIRQB+FQFIL Channel number times two; defines the channel on which 


the file is open. 


FIRQB+FQPPN The PPN under which the file is open. An actual PPN is 
returned here even if this word was passed as zero. 


FIRQOB+FQNAM1 The file name created, as two words of RAD50 data. 


FIRQB+FQEXT The file type created, as one word of RAD50 data. 


* FIRQB+FQSIZ 
FIRQB+FQBUFL 


FIRQB+FQFLAG 


FIRQB+FQPFLG 


FI ROB+FQPROT 
FIRQB+FQDEV 
FIRQB+FQDEVN 


FIRQB+FQCLUS 
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The size to which the file was preextended, in 512-byte 
blocks. 


Reasonable buffer size for disk reads and writes, in 
bytes. (Always 512 for disk.) 


Description of the device just opened (the same 
information as the BASIC-PLUS STATUS variable). The 
low byte contains the device’s handler index, always 
zero (DSKHND) for disk. The high byte contains a set 
of status flags, irrelevant here since the device is 
always disk. (See the OPNFQ subfunction for more 
information on these settings.) 


The file cluster size, modulo 256. That is, a file 
cluster size of 256 is indicated by zero. This is the 
same as the value passed at FIRQB+FQCLUS, except that 
it is returned in a byte instead of a word. 


The protection code of the file. Bit 6 is 1, and bits 
5 through 0 are as passed. Bit 7 is as passed if the 
caller has SYSIO privilege; otherwise it is 0. 


The device name of the disk device, as two ASCII 
characters. The actual device name is returned here, 
even if this word was passed as zero. 


The device unit number. The actual unit number is 
returned here, even if FIRQB+FQDEVN+1 was passed as 
zero. 


The file identification index of this file. This word 
is significant mainly in that it can be used in place 
of the file name in subsequent opens of the file on 
disk. You can open the file with the OPNFQ subfunction 
of CALFIP using an explicit PPN in FIRQB+FQPPN, a zero 
word in FIRQB+FQNAM1, an explicit device name in FQDEV 
and FQDEVN, and the file identification index in 
FIRQB+FQNAM1+2. 


Note that there is no performance gain for using the 
file identification index instead of the file name. 

The file identification index is provided for 
compatibility with RSX. Furthermore, the file 
identification index is changed when the REORDR utility 
is run (see the RSTS/E System Manager’s Guide). 
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CRBFQ 

Errors 

NOTCLS The specified channel is already open. It must be 
closed before it can be opened again. 

PRVIOL The specified device is not a disk device. The CRBFQ 
function can be executed only for a disk device. 

QUOTA Extending the file causes the disk quota to be 
exceeded. This error does not occur if the user has 
EXQTA privilege. 

XXXXX Other errors are device-dependent. See Appendix A for 
a full list of possible error codes. 

Example 


The following MACRO code sets up the FIRQB for the CRBFQ function of 
CALFIP. The PPN is set to 2,210; the file name and type are set to 
FILNAM.TYP. The protection code is set such that the file is 
read/write-protected against everyone but the caller (user with PPN 
2,210), and execute-protected against all but the caller and those in 
the caller’s project (users with project number = 2). The file is 
opened on disk unit 2 (DK2:). File size and cluster size are not 
specified. The cluster size defaults to the pack cluster size and the 
file size is not preallocated. 


DK: -ASCII /DK/ 


CALL CLRFQB ;CLEAR FIRQB 

MOVB #CRBFQ, FIRQB+FQFUN ;SET FUNCTION CODE 

MOVB #4*2,FIRQB+FQFIL ;SET CHANNEL = 4 

MOVB #2,FIRQB+FQPPN+1 ;SET PROJECT NUMBER =2 
MOVB #210.,FIRQB+FQPPN ;SET PROG. NO.=210. 

MOV #* RFIL, FIRQB+FQNAM1 ;SET FILE NAME AND 

MOV #* RNAM, FIRQB+FQNAM1+2 ;TYPE TO 

MOV #° RTYP, FIRQB+FQEXT >"FPILNAM. TYP" 

MOVB #<8.4+16.4+32.>,FIROB+FQPROT ;SET PROTECTION CODE 
MOVB #255.,FIROB+FQPFLG ;SET PROTECTION CODE REAL 
MOV DK, FIRQB+FQDEV ;SET DEVICE TO DISK, 

MOVB #2,FIRQB+FQDEVN ;UNIT 2 

MOVB #255.,FIRQB+FQDEVN+1 ;(EXPLICIT DEVICE NO.) 
CALFIP 


See Programming Hints for information on the CLRFQB routine. 
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CREFQ (Create a File and Open It on a Channel) 
Form 


MOVB #CREFQ, FIRQB+FQFUN ;SET FUNCTION CODE 


(set parameters appropriate to device) 


CALFIP 
Function 


The CREFQ function performs the same action as a file-structured OPEN 
FOR OUTPUT statement in BASIC-PLUS. Parameters defining the device, 
file name and type, protection code, mode, file size, and cluster size 
can be used by setting values in the FIRQB. The choice depends upon 
the device. 


For example, CREFQ with a file name and type on a magtape device with 
mode = 128 causes an OPEN for APPEND operation. A search for an 
existing file with the specified name and on the specified device is 
made; the file would have to be the last file on the tape. When 
found, the tape is positioned after the last record in the file, ready 
for data to be written and appended. The RSTS/E Programming Manual 
describes the file-structured OPEN for OUTPUT operation for the 
various devices. 


Privileges Required 


TUNE to set caching mode. SyYSIO to set the privilege bit (bit 7 in 
FQPROT). A matching PPN, GWRITE, WWRITE, and/or SYSIO to create or 
rename a file. You also need write access (by protection code, 
GWRITE, WWRITE, and/or SYSIO) to supersede an existing file. 
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Data Passed 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
torr ree ee ee eee eee tence eee ee eee eee eee eee + 
LYSSSIIIIISAIAIAAAI AAAS AAAI AAAS AAA AA AAAS A147 \ 9 
Sr tener ee ee ee ee ee ee eee + 
FOQFUN 3 | CRBFQ (= 4) WALLA 
Sr tere ee ee eee ee ee eee + 
FQSIZM 5 | MSB of file size | channel no. * 2 | 4 FQFIL 
Se t--- ee ee ee ee eee eee eee + 
7 | project number | programmer number | 6 FQPPN 
terre re ee ee ee ee eee terre ee eee eee + 
11 | file name in RAD50 format | 10 FQNAM1 
+ + 
13 | (2 words) | 12 
tener re ee ee ee eee Se + 
LS: file type in RAD50 format (1 word) | 14 FQEXT 
tener re et ee ee eee eee eee t--- eee ee ee eee eee eee + 
ET | LSB of file size | 16 FQSIZ 
5 terre er ee ee ee ee eee eee + 
ZL VSSSSSIAISAIIIAI AAAS AAA AAA AAA AAA AAAS 141671 \ 20 
Sr toe eee e e e e e e e eeeeeeee + 
23° || mode | 22 FQMODE 
tee eee eee ee eee eee eee te - 2 eer ee eee ee eee eee + 
25 VASSASAIIIISAIA AAA IAAIA AAAS AAA AAAS AAAS SASL | 24 
i terre ee ee eee ee eee eee + 
FQPROT 27 | file protection | #0, prot.code.real | 26 FQPFLG 
tenner re ee eee ee ee eee terre er ee ee ee eee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
teeter ere ee ee ee ee ee eee i + 
33 | #0, unit no. real | device unit number | 32 FQDEVN 
terre ree ee ee ee eee eee tere ee ee ee eee ee eee + 
35. file clustersize | 34 FQCLUS 
t--- eee ee ee ee eee ee eee tee ee ee ee ee eee eee eee + 
37 | device cluster number for first block | 36 FQNENT 
tener ete ee ee eee ee eee ce + 
FIRQB+FQFUN The function code CREFQ (octal value = 4). 
FIRQOB+FQFIL Channel number times two; defines the channel upon 
which the file is to be opened. 
FIRQB+FQSIZM For large disk files (greater than 65,535 blocks), this 


byte contains the most significant bits (MSB) of the 
file size. See FIRQB+FQSIZ, for a discussion of the 
entire 24-bit field used for large files on disk. 


FIRQB+FQPPN 


FIRQB+FQNAM1 
FIRQB+FQEXT 


FIRQB+FQSIZ 


FIRQB+FOQMODE 


FIRQB+FQPROT 


FIRQB+FQDEV 
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The PPN with which the file is to be created. The 
project number is in the high byte (FIRQB+FQPPN+1), and 
the programmer number in the low byte (FIRQB+FQPPN). A 
value of zero defaults to the PPN under which the 
calling program is running. 


The file name to create, as two words of RAD50 data. 
The file type, as one word of RAD50 data. 


The desired file size, in 512-byte blocks. fThis 
parameter is relevant only for disk and ANSI magtape 
files. For disk files, this word forms the least 
Significant bits (LSB) of the file size. It is 
combined with the byte at FIRQB+FQSIZM to form a 24-bit 
integer. The disk file is automatically preextended to 
the indicated size. (That is, the space for the file 
is allocated when the file is opened, not as it is 
written.) If preextending is not desired then this 
value and FIRQB+FQSIZM should be zero. 


For ANSI magtape, this word has the same function as 
the FILESIZE option in BASIC-PLUS (see the RSTS/E 
Programming Manual). 


The mode with which the file is to be opened; values 
and actions taken for specific devices are as described 
for the MODE modifier for file-structured OPEN for 
OUTPUT statements in the RSTS/E Programming Manual. If 
a mode value is used, bit 15 of this word must be set 
to l. 


File protection code; values for this field define 
subsequent read and write access to the opened file 
(see the RSTS/E System User’s Guide). If you want a 
default protection code, then set a full word of zeros 
at FIRQB+FQPFLG. In this case, either the system 
default for protection code will be used, or, if the 
CREFQ will be deleting a previously existing file with 
the same file name, type, ppn, and device, the file 
protection code of the previously existing file will be 
used. 


To assign a specific file protection code, put a 
nonzero value in byte FIRQB+FQPFLG (by convention, 255) 
and the specific file protection code in byte 
FIRQB+FQPROT. This allows an explicit file protection 
code of 0. 


The device name is passed here as two ASCII characters. 
A zero word indicates the public disk structure. 
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FIRQB+FQDEVN 


FIRQB+FQCLUS 


FIRQB+FQNENT 


The device unit number is passed here in binary. A 
nonzero value in FIRQB+FQDEVN+1 indicates an explicit 
device unit number. A zero value in FIRQB+FQDEVN+1 
indicates no unit number. 


This parameter has the same function as the CLUSTERSIZE 
option in BASIC-PLUS. It is relevant only for disk 
files and ANSI magtape files. A description of the 
CLUSTERSIZE option for disk is given in the BASIC-PLUS 
Language Manual; for ANSI magtape, in the RSTS/E 
Programming Manual. 


For disk files, the device cluster number for placement 
of block 1 of the file. When creating a new file, you 
can place block 1 of the file on a particular block by 
specifying the disk device cluster number in this word. 
If this word is zero, no placement is done. If it is 
nonzero, the monitor will try to place the file at the 
specified device cluster or as near after it as 
possible. If the first block of the file can be placed 
at or after the specified device cluster number, the 
monitor sets a bit in the file’s entry in the UFD. If 
the first block of the file cannot be placed at or 
after the specified device cluster number, the file is 
placed at the lowest free block on the disk, the bit in 
the file’s entry in the UFD is not set, and no error is 
returned. 


A value of -1 means the center of the disk; a value of 
-2 means immediately after the directory. 


Data Returned 


FIRQB 
Mne- Octal Octal 
monic Offset Offset 
t-- ree ee ee ee eee eee eee tee ee ee ee ee eee eee eee + 
Li SSSLOSS II EPVLAA TATA AAA TIA IS AAAS I TIS SILLS 7 |) 8 
tee ee ee ee ee ee ee eee terre ee ee ee ee eee + 
ZS ISSISIIIISS111////////\ cacrent job no. * 2 | 2 
5 Se + 
FQSIZM 5 | MSB of file size | channel number * 2 | 4 
tere ee eee ee ee ee eee eee terre et er re ee ee eee eee + 
7 | project number | programmer number | 6 
Se tern re re ee ee eee ee eee + 
ll | file name in RAD50 format | 10 
+ + 
13 | (2 words) | 12 
Se tee eee eee ee eee eee eee + 
15. .| file type in RADS50O format (1 word) | 14 
terre eee ee ee ee eee eee Sl + 
17 | LSB of file size | 16 
5 terre cer re ee ee eee eee + 
21 | eeaconabie buffer size for device | 20 
tee eee ee eee ee ee ee eee t---- ee eee er ee ee ee eee + 
23 | (as passed) li pee 
tere er eee ee eee ee eee te -- ee eee ee ee ee ee eee + 
25 | device description | 24 
t-- 2 ee eee ee ee ee ee eee +--- eee eee ee ee ee ee eee + 
FQPROT 27 | Beoeeceuee code | clustersize, mod256 | 26 
tere ree ee ee ee eee eee t-- ee e e ee eee eee + 
31 | device name (2 ASCII characters) | 30 
tee eee eee ee ee eee eee terre ee eee ee ee ee eee + 
33 | shag byte | device unit number | 32 
tee nner ee ee eee eee ee eee tere re ee ee ee eee eee eee + 
35° | file identification index | 34 
tee - eee ee ee eee eee ee eee tenn nee ee ee ee ee eee eee + 
37 | (as passed) | 36 
tere ree ee ee ee ee eee eee tee eee ee ee ee ee eee eee + 
Note 


For nondisk devices, 


with the CREFQ subfunction is in the two words at 


FIRQB+FQBUFL and FIRQB+FQFLAG. 
simply returned as passed. 


FIRQB+FQJOB Current job number times two. 


FIRQOB+FOFIL Channel number times two; 


the file is open. 


All other words are 
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Mne- 
monic 


FQJOB 
FOFIL 
FOPPN 


FQNAM1 


FQEXT 
FOQSIZ 
FQOBUFL 
FQOMODE 
FQOFLAG 
FQPFLG 
FQDEV 
FQDEVN 
FQCLUS 


FOQNENT 


the relevant information returned 


defines the channel on which 
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FIRQB+FQSIZM For large files, this byte contains the MSB of the size 
to which the file was preextended, in 512-byte blocks. 
This byte is combined with the word at FIRQB+FQSIZ to 
form a 24-bit field giving the file size. 

FIRQB+FQPPN The PPN under which the file is open. An actual PPN is 
returned here even if this word was passed as zero. 

FIRQB+FQONAM] The file name created, as two words of RAD50 data. 

FIRQB+FQEXT The file type created, as one word of RAD50O data. 

FIRQB+FQSIZ The size to which the file was preextended, in 512-byte 
blocks. 

FIRQB+FQBUFL Reasonable buffer size for this device, in bytes. If 
you are doing device-independent I/O (that is, if you 
do not want to keep track of which device is being 
opened and perform specific opens, reads, and writes, 
depending on the device), this value is the monitor’s 
best guess for a buffer size to use in subsequent reads 
and writes on the opened channel. (See the .READ and 
-WRITE directives. ) 

FIRQB+FQFLAG Description of the device just opened (same information 
as the BASIC-PLUS STATUS variable). The low byte 
contains the device’s handler index. There is one 
unique handler index for all device types. The high 
byte contains a set of status flags to allow for 
device-independent I/0 routines. 

DDNFS 

DDRLO | 

DDWLO | | 

FLGPOS | | | 

FLGMOD | | | | 

FLGFRC | | | | | 

FLGKB | | | | | | 

FLGRND | | | | | | | 

| | ae ee oy one 
15 1413121110 9 8| 7 0 
Se terre ee ee eee eee eee + 
| device-type flags | device handler index | 
terre re ee ee eee eee SS + 


High Byte - Device-Type Flags 


The bits in the high byte of the flags word are set to 
indicate the type of file or device just opened: 


l1 The device or file is random-access. 
0 The device or file is sequential. 


FLGRND 
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FLGKB = 


FLGFRC = 


FLGMOD 


FLGPOS = 


DDWLO 


DDRLO = 


DDNFS = 


Low Byte 
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The file or device is a terminal-type file 
or device (or is generically a terminal). 
The file or device is not a terminal-type 
file or device. 


The file or device is byte-oriented. That 
is, the .READ and .WRITE directives handle 
data in byte units. 

The file or device is block-oriented. The 
-READ and .WRITE directives handle data in 
block units. 


The file or device accepts modifiers in 
-READ and .WRITE directives. 

The file or device does not accept modifiers 
in .READ and .WRITE directives. 


The file or device keeps track of its 
horizontal position and expands characters 
such as TAB into whatever is appropriate for 
the file or device. You can determine the 
current horizontal position with the .POSTN 
directive. 

The file or device does not keep track of 
its horizontal position. 


The file or device has been write-locked 
(with the mode value in the open) or is 
generically a read-only device. 

The file or device is not write-locked. 


The device is generically a write-only 
device. 
The file or device is not read-locked. 


The file or device is non-file-structured 
(or is generically not a file-structured 
device). 

The file or device is file-structured. 


Device Handler Index 


Bits 0-7 of the flags word contain a handler index that 
indicates the generic kind of device. The currently 
defined values follow. 
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t------- +-------- tee eee ee ee ee ee ee ee eee ee ee eee + 
| Octal | | | 
| Value | Symbol | Meaning | 
+------- +-------- Hen ee ee ee ee ee ee ee eee + 
| | | | 
| 0 | DSKHND | All disks | 
| 2 | TTYHND | All terminals | 
| 4 | DTAHND | DECtape | 
| 6 | LPTHND | All line printers | 
| 10 | PTRHND | Paper tape reader | 
| 12 | PTPHND | Paper tape punch | 
| 14 | CDRHND | Card reader | 
| 16 | MTAHND | Magnetic tape | 
| 20 | PKBHND | Pseudo keyboards | 
| 22 | RXDHND | Flexible diskettes | 
| 24 | RJEHND | 2780 remote job entry | 
| 26 | NULHND | The null device | 
| 30 | DMCHND | The DMC11/DMR11 DDCMP interface | 
| 36 | Reserved | 
| 40 | KMCHND | KMC1ll | 
| 42 | IBMHND | IBM interconnect | 
| 46 | DMPHND | DMP11/DMV11 device | 
t------- +-------- Dl + 


FIROB+FQOPFLG The file cluster size, modulo 256. That is, a file 
cluster size of 256 is indicated by zero. This is the 
same as the value passed at FIRQB+FQCLUS, except that 
it is returned in a byte instead of a word. 


FIRQB+FQPROT The protection code of the file. Bit 7 is as passed if 
the caller has SYSIO privilege, and 0 otherwise; bits 6 
to 0 are as passed. 


FIRQOB+FQDEV The device name of the disk device, as two ASCII 
characters. The actual device name is returned here, 
even if this word was passed as zero. 


FIRQB+FQDEVN The device unit number. The actual unit number is 
returned here, even if FIRQB+FQDEVN+1 was passed as 
zero. 


FIRQB+FQCLUS The file identification index of this file. This word 
is significant mainly in that it can be used in place 
of the file name in subsequent opens of the file on 
disk. You can open the file with the OPNFQ subfunction 
of CALFIP using an explicit PPN in FIRQB+FQPPN, a zero 
word in FIRQB+FQNAM1, and the file identification index 
in FIRQB+FQNAM1+2. 
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Note that there is no performance gain for using the 
file identification index rather than the file name. 
The file identification index is provided for 
compatibility with RSX. Furthermore, the file 
identification index is changed when the REORDR utility 
is run (see the RSTS/E System Manager’s Guide). 


Errors 

NOTCLS The specified channel is already open. It must be 
closed before it can be opened again. 

QUOTA Extending the file causes the disk quota to be 
exceeded. This error does not occur if the user has 
EXQTA privilege. 

XXXXX Other errors are device-dependent. See Appendix A for 
a full list of errors. 

Example 


The following MACRO code sets up the FIRQB for a CREFQ that opens a 
file called FILEO01.LST on the public disk structure. (The assumption 
here is that previous code has filled the FIRQB with zeros, so the 
words at FIRQB+FQDEV and FIRQB+FQDEVN are zero, indicating the public 
disk. Similarly, the mode (FIRQB+FQMODE) and cluster size 
(FIRQB+FQCLUS) are zero, indicating normal read/write and the default 
cluster size.) A protection code of 56 is assigned (write-protected 
against all but the owner, read-protected against all but those in the 
owner’s project). 


MOVB #CREFQ, FIRQOB+FQFUN ; Set function code in FIRQB 
MOVB #5*2,F IROB+FOFIL ; Set channel = 5 

MOV #° RFIL, FIROB+FQNAM1 ; Set file name 

MOV #° REO], FIRQB+FQNAM1+2 ; and type to 

MOV #° RLST, FIROB+FQEXT : FILEO1.LST 

MOVB #56.,FIRQB+FQPROT ; Set protection code to 
MOVB #255.,FIRQB+FQPFLG ; explicit protection code 
CALFIP 


CALFIP 
CRTFQ 


CRTFQ (Create and Open a Temporary File) 
Form 


MOVB #CRTFQ, FIRQB+FQFUN 


° 


(set appropriate parameters) 


CALFIP 
Function 


The CRTFQ function can be used to create and open a temporary file on 
disk. The file is temporary only in that the monitor generates a file 
name and type for the file, which is recognized by the LOGOUT utility. 
LOGOUT destroys such files when the user logs out; the monitor does 
not inherently destroy temporary files created with CRTFQ. 


Most parameters relevant on an open are defaulted. You do not define 
or refer to the file by name; subsequent read and write operations 
refer to the channel on which the temporary file is open. 


In addition to the function code, you specify a channel and, if 
desired, a file size and/or file cluster size. If an explicit cluster 
Size is specified, it is used. A specified file size may or may not 
be used. The monitor attempts to reuse an existing temporary file for 
the same job by simply reopening that file. In this case, the file’s 
Size is the size of the previous file. If no previous temporary file 
for the job exists, or if one does exist but is already in use by 
somebody else, then a new file is created, with the specified file 
Size. A new file is also created if an explicit device name or 
cluster size is given. 


Privileges Required 


TUNE to set caching mode. You also need write access (by protection 
code, GWRITE, WWRITE, and/or SYSIO) to supersede an existing file. 


Data Passed 


CALFIP 
CRTFQ 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
preter eee eee ee ee ee eee tere eee ee ee ee ee ee ee eee + 
1 Vadaaaiiiiiia 0 
ee + 
FOQFUN 3 CRTFQ (= 32) VSSSIISPATSLP LISI ILLS 2 
tere ee ee ee ee ee ee ee eee tere ee ee ee ee ee eee eee + 
FQSIZM 5 | MSB of file size | channel no. * 2 | 4 FQFIL 


7 VL 6 
11 TEESE GB ASA AAG EMME EA CaM ABE AAMC 10 
13 QE 12 


terre ere eee ee ee eee eee Sr + 

LS |SSSASASIAIAI SALA AS AAAI AAA AAAS AAA AAAS \ 34 
terre eee ee ee eee ee ee eee 5 el + 

17 | LSB of file size | 16 FQSIZ 
Se 5 + 

21 LT CO ne: 20 
a a oe + 

23 | ands | 22 FQMODE 
tenner ee eee ee ee eee eee Her cee eee ee ee ee eee + 


ZS YSSSSSSSISIIISIIAAAA SAAS ASS SSSAS 1117 2 


tere eee ee ee ee ee ee ee eee terre ee eee ee eee ee ee eee + 
27 UO eRe ACLS ERAGE A KEENER EGE ease 26 
ee i i + 
31 | device name (2 ee pera Gree) | 30 FQDEV 
tere e ee ee eee ee ee ee eee terre ne ee ee ee ee eee + 
33 | #0, unit no. real | device unit ane | 32 FQDEVN 
+e eee eee ee ee eee ee eee terre eee ee ee eee eee eee + 
35) || file cluster size | 34 FQCLUS 
tere ree eee ee ee ee ee eee terre ee eee eee ee eee eee + 
37 || device cluster number for this block | 36 FQNENT 
tern eee ee ee ee ee ee ee eee tere eee eee ee eee eee eee + 
FIRQB+FQFUN The function code CRTFQ (octal value = 32). 
FIRQB+FQFIL Channel number times two; defines the channel on which 
the file is to be opened. 
FIRQB+FQSIZM For large disk files (greater than 65,535 blocks), this 
byte contains the MSB of the file size. See 
FIRQB+FQSIZ, for a description of how the entire 24-bit 
field is used. 
FIRQOB+FQSIZ This word contains the LSB of the file’s size in 


512-byte blocks. (It is combined with the byte at 
FIRQB+FQSIZM.) The file size may or may not be used. 
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CALFIP 
CRTFQ 


FIRQB+FQMODE 


FIT RQB+FQDEV 


FIRQB+FQDEVN 


FIRQB+FQCLUS 


FIRQB+FQNENT 


If a temporary file already exists that is not in use, 
the monitor uses the space allocated to the previous 
temporary file. However, if cluster size is specified, 
a new file is created, and the file size indicated by 
the 24-bit file size is used. 


The mode with which the file is to be opened. Values 
are as described for the MODE modifier in OPEN for 
OUTPUT statements for disk (see the RSTS/E Programming 
Manual). The only relevant modes are for creating a 
tentative file, creating a contiguous file, creating a 
conditionally contiguous file, and for data caching. 
All other mode bits are ignored, except bit 15. Ifa 
mode value is used, bit 15 of this word must be set to 
1. 


The device name is passed here as two ASCII characters; 
it must be a disk device. A value of zero in this word 
indicates SY:, the public disk. 


The device unit number is passed here in binary. A 
nonzero value in the high byte (FIRQB+FQDEVN+1 ) 
indicates an explicit device unit number. A zero value 
in FIRQB+FQDEVN+1 indicates no unit number. 


File cluster size. Performs the same function as the 
CLUSTERSIZE option in BASIC-PLUS. 


The device cluster number for placement of block 1 of 
the file on disk. When creating a new file, you can 
place block 1 of the file on a particular block by 
specifying the disk device cluster number in this word. 
If this word is zero, no placement is done. If it is 
nonzero, the monitor tries to place the file at the 
specified device cluster or as near after it as 
possible. If the first block of the file can be placed 
at or after the specified device cluster number, the 
monitor sets a bit in the file’s entry in the UFD. If 
the first block of the file cannot be placed at or 
after the specified device cluster number, the file is 
placed at the lowest free block on the disk, the bit in 
the file’s entry in the UFD is not set, and no error is 
returned. 


A value of -1l means the center of the disk; a value of 
-2 means immediately after the directory. 


Data Returned 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tee eee eee ee eee eee eee +e - ee ee ree ee ee ee eee eee + 
1 a Ee 0 
Se i es + 
3 WZ current job no. * 2 | 2 FQUJOB 
i aS + 
FQOSIZM 5 MSB of file size i channel no. * 2 | 4 FQFIL 
tere ere ee ee ee ee ee ee eee Sl + 
7 project number | programmer number | 6 FQPPN 
Stitt a + 
11 file name in RAD50 format | 10 FQNAM1 
+ + 
13 (2 words) | 12 
Sl tee err re eee ee eee + 
15 file type in RAD50 format (1 word) | 14 FQEXT 
tee eee eee ee ee ee ee eee terre rr ee re ee ee ee eee + 
17 LSB of file size | 16 FOSIZ 
ten eee re ee ee eee eee eee Se + 
21 reasonable buffer size for device | 20 FQBUFL 
terre te ee ee ee ee ee ee eee tee ere ee ee ee ee eee eee + 
23 | (as passed) | 22 FQMODE 
te - rete ee ee ee eee eee eee ter creer eee eee eee eee + 
Z5 | device description | 24 FQFLAG 
teen rte ee ee ee ee ee ee eee t--- ere eee eee eee eee + 
FQPROT 27 | provectson code | clustersize, mod256 | 26 FQPFLG 
t--- eee ee ee ee ee ee ee eee tee ee ree ee eee ee eee eee + 
Sa. ii device name (2 ASCII characters) | 30 FQDEV 
t--- eee re ee eee ee eee eee t--- eee er ee ee ee ee ee + 
33 | flag byte | device unit number | 32 FQDEVN 
teen eee ee ee eee ee eee eee tener re re ee ee ee ee eee + 
35°" | file identification index | 34 FQCLUS 
terre ree ee eee eee eee toe re er re ee ee ee eee eee + 
37 | (as passed) | 36 FQNENT 
terre ee eee ee ee ee eee eee Se + 

FIRQB+FQJOB Current job number times two. 

FIRQB+FQFIL Channel number times two; defines the channel on which 
the file is open. 

FIRQB+FQSIZM For large disk files (greater than 65,535 blocks), 
byte contains the MSB of the file size in 512-byte 
blocks. It is combined with the word at FIRQB+FQSIZ to 
form a 24-bit field giving the file size. 

FIRQB+FQOPPN The PPN under which the file is open. An actual PPN is 


CALFIP 


returned here even if this word was passed as zero. 
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FIRQB+FQNAM1 
FIRQB+FQEXT 


FIRQB+FQSIZ 


FIRQB+FQBUFL 


FIRQB+FQFLAG 


FIRQB+FQPFLG 


FIRQB+FQPROT 


FIRQB+FQDEV 


FI ROB+FQDEVN 


FIRQB+FQCLUS 


The file name created; two words of RAD50 data. 
The file type created; one word of RAD50 data. 


The size to which the file was preextended, in 512-byte 
blocks. 


Reasonable buffer size for disk reads and writes, in 
bytes. (Always 512. for disk.) 


Description of the device just opened (the same 
information as the BASIC-PLUS STATUS variable). The 
low byte contains the device’s handler index, always 
zero (DSKHND) for disk. The high byte contains a set 
of status flags, irrelevant here since the device is 
always disk. See the OPNFQ subfunction for more 
information about these settings. 


The file cluster size, modulo 256. That is, a file 
cluster size of 256 is indicated by zero. This is the 
same as the value passed at FIRQB+FQCLUS, except that 
it is returned in a byte instead of a word. 


The protection code of the file. 


The device name of the disk device, as two ASCII 
characters. The actual device name is returned here, 
even if this word was passed as zero. 


The device unit number. The actual unit number is 
returned here, even if FIRQB+FQDEVN+1 was passed as 
zero. 


The file identification index of this file. This word 
is significant mainly in that it can be used in place 
of the file name in subsequent opens of the file on 
disk. You can open the file with the OPNFQ subfunction 
of CALFIP using an explicit PPN in FIRQB+FQPPN, a zero 
word in FIRQB+FQNAM1, and the file identification index 
in FIRQB+FQNAM1+2. 


Note that there is no performance gain for using the 
file identification index rather than the file name. 
The file identification index is provided for 
compatibility with RSX. Furthermore, the file 
identification index is changed when the REORDR utility 
is run on the directory (see the RSTS/E System 
Manager’s Guide). 


CALFIP 


CRTFQ 

Errors 

QUOTA Extending the file causes the disk quota to be 
exceeded. This error does not occur if the user has 
EXQTA privilege. 

XXXXX All other errors for this directive are 
device-dependent. See Appendix A for a full list of 
errors. 

Example 


The following MACRO code opens a temporary file on channel 13. Assume 
that the FIRQB has been initialized to all zeros. Hence, the 
temporary file is created on the public disk structure: 


MOVB #CRTFQ, FIRQB+FQFUN ;SET FUNCTION CODE 
MOVB #13.*2,FIRQB+FQFIL ;SET CHANNEL TO 13 
CALFIP 


CALFIP 

DALFQ 

DALFQ (Deallocate All Devices) 
Form 


MOVB #DALFQ, FIRQB+FQFUN 
CALFIP 


Function 


The DALFQ subfunction deallocates all devices currently allocated to 
the job. 


Privileges Required 


None 


CALFIP 
DALFQ 


Data Passed 
Mne- Octal Octal Mne- 


monic Offset Offset monic 


1 CIA ACh INRA AG AEA PALER eig 0 


ie AAA 


Hoenn eee ee ee ee eee foc e eee eee eee eee eee + 


TNALISILISA ATTA TAS SAAS A ASAATS AA AAALS FETAL IT EL |. ® 


FIRQB+FQFUN The function code DALFQ (octal value = 30). 

Data Returned 

The DALFQ subfunction of CALFIP does not return any meaningful data. 
Errors 


No errors are possible with DALFQ. 


CALFIP 

DEAFQ 

DEAFQ (Deallocate a Device) 
Form 


MOVB #DEAFQ, FIRQB+FOQFUN 
(Define device to be deallocated in FIRQB) 


CALFIP 
Function 


The DEAFQ subfunction deallocates (that is, releases it for use by 
other jobs) a device from the current job. 


Privileges Required 


None 


Data Passed 


CALFIP 
DEAFQ 


FIRQB 

Mne- Octal Octal Mne- 
monic Offset Offset monic 

tere er eee ee ee ee ee ee eee tere eee ee ee ee ee ee ee eee + 

1 VLLLELLLLLLLLLLLLLLLLLLL LLL LLL LLL LL LLL LLL LLL | 0 

tee eee ee ee ee eee ee eee +--- + ee ee ee ee ee eee eee + 
FQFUN 3 | DEAFQ (= 26) VAAL AAA hhh: 

terre eee eee ee eee eee te -- ee ee ee ee eee ee eee + 


d Vad 6 


ie = 0) | 10 FQNAM1 


device name (2 ASCII characters) | 30 FQDEV 


#0, unit no. real | device unit number | 32 FQDEVN 


37 I LPILILIDILI ITLL IL ILTLT ELI IDILTLD ILIAD EDT 36 


FIRQB+FQFUN 
FIRQB+FQNAM1 


FIRQOB+FQDEV 


FT ROQB+FQDEVN 


The DEAFQ function code (octal value = 26). 
The word at this location must be set to zero. 


The name of the device to be deallocated, as two ASCII 
characters. 


The device unit number is passed here in binary. A 
nonzero value in FIRQB+FQDEVN+1 indicates an explicit 
device unit number, while a zero value indicates no 
device unit number. 


CALFIP 
DEAFQ 


Data Returned 


Except for a possible error in byte 0 of the FIRQB, the DEAFQ 
subfunction of CALFIP does not return any meaningful data. 


Errors 

NODEVC The device or its type specified at FIRQB+FQDEV and 
FIRQB+FQDEVN is not part of your system configuration. 

Example 


The following code deallocates LP: from the current job: 


CALL CLRFQB > Clear FIRQB 

MOVB #DEAFQ, FIRQB+FQFUN ; Set function code 
MOV #"LP,FIRQOB+FQDEV ; Device=line printer 
CALFIP 


See Programming Hints for information on the CLRFQB routine. 


CALFIP 
DIRFQ 
DIRFQ (Get Directory Information) 
Form 


MOVB #DIRFQ, FIRQB+FQFUN 
(Define device for the directory wanted) 


CALFIP 
Function 


The DIRFQ subfunction of CALFIP returns directory information about a 
disk, DECtape, or magtape file. Two forms of the call are available. 
One leaves a magtape file positioned at the EOF and returns the size 
of the file as part of the directory information. The second form, 
for magtape only, leaves a magtape file positioned at the beginning of 
the file, and does not return the size of the file. 


Note 


For disk directory lookup on a PPN other than that of 
the caller, DIRFQ returns only those files to which 
the caller has read or execute access. 


Privileges Required 


DEVICE to perform a directory lookup or disk lookup on caller’s 
account if the referenced device is restricted. You need read or 
execute access (by protection code, GREAD, or WREAD) to perform a disk 
directory lookup on another account. 


CALFIP 
DIRFQ 


Data Passed ~- Directory Lookup on Index 
FIRQB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 


UV AAA hhh 
FQFUN 3 | DIRFQ (= 12) WAAL hhh 
5 index of file to read | 4 FQFIL 


a project number | programmer number | 6 FQPPN 


31 | device name (2 ASCII characters) | 30 FQDEV 


33 | #0, unit no. real | device unit number | 32 FQDEVN 


37 I LPLLIL LIL ILILILILT ITIL ILILIL ILIAD LOE 36 


FIRQB+FQFUN The function code DIRFQ (octal value = 12). 


FIRQB+FOFIL The index of the file to read. If this word is zero, 
the monitor returns data for the first file in the 
Girectory. For some positive value n, the monitor 
returns data for the n+l file in the directory. For 
magtape, a value of zero causes the monitor to rewind 
the tape before it gets the information for the first 
file (by reading the label record of the file). The 
monitor then spaces the tape forward to the next EOF 
record and calculates the number of records in the 
file. The tape is left in that position. 
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FIRQB+FQPPN 


FIRQB+FQDEV 


FIT RQB+FQDEVN 


CALFIP 
DIRFQ 


A nonzero value performs the same action, except that 
the tape is not rewound. 


For DECtape, the first call issued must have a value of 
zero in this word to read the directory blocks from the 
tape before reading the first file. Subsequent calls 
with this word nonzero read the directory from the 
BUFF.SYS file. (Directory information for DECtape is 
kept in this system file on disk to speed up DECtape 
file processing: see the RSTS/E Programming Manual.) 


The PPN of the directory to look up, for disk or 
magnetic tape. (The monitor does not use these bytes 
if the device is DECtape but simply returns information 
for each file read on the device.) 


If this word is zero and the device is disk, this 
directive returns information for the PPN under which 
this job is being executed. 


If this word is zero and the device is magnetic tape, 
this directive returns information for each file read, 
regardless of the PPN under which it was written. 


The device name, as two ASCII characters. Must be 
disk, magnetic tape, or DECtape. If this word is zero, 
the public disk structure (_SY:) is used. 


The device unit number is passed here in binary. A 
nonzero value in FQDEVN+1 indicates an explicit device 
unit number. A zero value in FQDEVN+1 indicates no 
unit number. 


CALFIP 
DIRFQ 


Data Passed - Special Magnetic Tape Lookup 
FIRQB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 


1 NELLA NAL SSSR SEMEL AEE RACAL. 0 
FQFUN 3 | DIRFQ (= 12) WLLL 2 
5.4 index of file to read | 4 FQFIL 


zd) must = 177777 for magnetic tape lookup | 6 FQPPN 
Ste Se + 


11 ESR AA NEEM ASAE T La LEI 10 
13 Vdd 12 
15 Ueda 14 
17 Ueda 16 
21 Vad 20 
23 LLILILILLILILT ILI TEL ILA IDTED AL ILYET EY 22 
25 TO ee 24 
27 Ueda 26 
31. | device name (2 neers characters) | 30 FQDEV 


33 | #0, unit no. real | device unit number | 32 FQDEVN 
teeter eee ee ee ee ee ee eee tener eee eee ee eee eee eee + 


35 HO I ge 34 
37 Veda 36 


FIRQB+FQFUN The function code DIRFQ (octal value = 12). 


FIRQB+FOQFIL Index number of the file to be read. If this word is 
zero, information is returned for the first file in the 
directory. If this word is some positive value n, 
information is returned for the n+l file in the 
directory. A value of zero causes the monitor to 
rewind the tape before getting information from the 
first file (by reading the label record). It then back 
Spaces the tape one record, leaving it positioned at 
the beginning-of-file (BOF). (This action leaves the 
tape positioned such that an open on this file will 
succeed on a single read from tape.) 
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FIRQB+FQPPN 


FIRQB+FQDEV 


FIRQB+FQDEVN 


CALFIP 
DIRFQ 


A nonzero value does not cause the tape to be rewound; 
the next record is read (it must be a label), and the 
tape is backspaced one record. When you are searching 
a tape for specific files to read, the normal action is 
to execute this directive with a value of zero first. 
If the file is one to be read, open the file requesting 
no rewind, process the file, and close it to position 
the tape at the EOF. If the file is not one to be 
read, space the tape forward to the next EOF. (You can 
do this in MACRO with the .SPEC directive.) Then issue 
the DIRFQ call with a nonzero value in the word 
beginning at FIRQB+FQFIL, and continue the process. 


This word must be set to 177777 for the special 
magnetic tape lookup operation. 


The device name as two ASCII characters. The device 
must be a magnetic tape drive. 


The device unit number, in binary. A nonzero value in 
FIRQB+FQDEVN+1 indicates an explicit device unit 
number. <A zero value in FIRQOB+FQDEVN+1 indicates no 
unit number. 4 


CALFIP 
DIRFQ 


Data Returned (Both) 


Mne- Octal 


monic Offset 


FIRQB 
Octal Mne- 
Offset monic 
wee eee ee ee ee eee eee no 


1 ARG TEEACL SASS ALLL EL AGRA EM RAES GEA L CLILGLA CGA: 0 


Se + 
3  PYILIILLIPPILLIL LID current job no. * 2 | 2 FQJOB 
tenn ree ree ee eee eee tee eee ee eee eee eee eee + 
5. | (aS passed) | 4 FQFIL 
tee eee eee ee ee ee ee eee tee eee ee ee eee ee eee + 
7 | project number | programmer number | 6 FQPPN 
tee ee er er ee ee ee eee eee tone ee ee ee ee ee eee + 
11 | file name in RAD50 format | 10 FQNAM1 
+ + 
13 | (2 words) | 12 
Se tee eee eee ee eee ee eee ee + 
15 | file type in RAD50 format (1 word) | 14 FQEXT 
Se tee ee ee ee ee eee eee eee + 
17 | LSB of file length in blocks | 16 FQSIZ 
Se tere eee ee ee ee ee eee eee + 
21 | MSB of file length | protection code | 20 FQNAM2 
Se tee eee ee ee ee eee eee eee + 
23 | date of last access | 22 FQMODE 
t---- ee ee re ee eee eee tere ee ee eee ee eee eee + 
25. || date of creation | 24 FQFLAG 
terre eee ee ee ee eee eee terre eee eee eee eee eee + 
27: || time of creation | 26 FQPFLG 
Se tere eee eee ee ee eee eee + 
31 | | 30 FQDEV 
+ (as passed) + 
33 | | 32 FQDEVN 
tee - ree ee ee ee ee eee eee terre ee eee ee eee eee ee + 
35. || file clustersize (disk only) | 34 FQCLUS 
Se tener eer eee ee eee eee + 
37 | USTAT byte | number entries ret. | 36 FQNENT 
ten rr ee ee ee ee re ee eee tence ee ee ee ee eee eee eee + 

FIRQB+FQJOB The current job number times two. 

FIRQB+FQPPN The PPN of the file. The project number is in the high 
byte (FIRQB+FQPPN+1) and the programmer number is in 
the low byte (FIRQB+FQPPN). 

FIRQB+FQNAM1 The file name; two words in RAD50 format. 

FIRQB+FQEXT The file type; one word in RAD50 format. 

FIRQOB+FQSIZ The LSB of the file size, in 512-byte blocks. This 


word is combined with the byte at FIRQB+21 to form a 
24-bit value giving the file’s size. 
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FIRQB+FQNAM2 


FIRQB+FQNAM2+4+1 


FIRQB+FQMODE 


FIRQB+FQFLAG 


_ FIRQB+FQPFLG 


FIRQB+FQCLUS 


FIRQB+FOQNENT 


FIRQB+FQNENT+1 


CALFIP 
DIRFQ 
The protection code of the file. 


The MSB of the file’s size in 512-byte blocks (see 
FIRQB+FQSIZ). 


The date the file was last accessed, in system internal 
format: 


[(year - 1970) * 1000.} + day-within-year 


See the .DATE directive for a discussion of the system 
internal format for dates. 


The date the file was created, in system internal 
format. 


The time that the file was created, in system internal 
format: minutes before midnight, where midnight = 
1440. (See the .DATE directive for a discussion of the 
system internal format for time.) 


The file cluster size for disk devices. It is not used 
for tape. 


Number of entries returned: 8 for disk; 6 for tape. 


Internal flag information (disk only): 


Bit Meaning When Set 
1 File is placed 
2 Some job has write access now 
3 File is open in update mode 
4 File is contiguous; no extend allowed 
5 No delete or rename allowed 
7 File is marked for deletion 


CALFIP 


DLNFQ 


Data Passed 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tere ee ee ee ee ee ee ee eee ter ee ee eee ee ee eee eee + 
1 COANE SA EU MELA LAER IES DEAS AKAM 0 
i i i oS + 
FQFUN 3 | DLNFQ (= 6) V/PSILSIITLPIISIA TLL AT 2 
Henne ee ee ee eee eee eee terre eee ee ee ee ee ee eee + 
SISA LSSSLISTI ALIAS AAAI ALAS ISA ALIAS SSA LILI TI / |... 4 
teen ee ee eee ee ee eee eee tee ee ee ee ee ee ee ee eee + 
7 | project number | programmer number | 6 FQPPN 
Herne er ee eee ee eee ee eee tere ee ee ee ee ee ee eee eee + 
Ll file name in RAD50O format | 10 FQNAM1 
+ + 
13 | (2 words) | 12 
tee eee ee eee ee ee eee eee tee eee ee ee ee ee ee eee ee + 
15 | file type in RAD50 format (1 word) | 14 FQEXT 
teen ee ee eee eee ee ee eee tere ee ee ee ee ee ee eee eee + 
17 VO EN EE LE 16 
tere ee ee ee pe ee ee ee ee ee ee eee + 
21 yyy 20 
tere ee eee eee eee ee ee eee terre ee ee ee ee eee eee eee + 
23 LGA LOT LET AL 22 
i ee i oe + 
25 yn 24 
tee ee eee eee ee ee eee eee terre eee ee ee ee ee eee eee + 
2T VWASAAISAIIAISAAIAI AAAS AAA AAAS AAA AAAS AAA AS | 28 
i i rr terre eee ee ee ee ee eee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
i ra terre eee eee ee eee eee eee + 
33 | #0, unit no. real | device unit number | 32 FQDEVN 
i i eae tere eee ee ee ee ee eee eee + 
35 A oh I EI MAE AMAA 34 
ter ee ee ee ee epee ee ee ee ee eee eee + 
ah yyy 36 
tere ee ee eee ee ee eee eee terre eee ee ee ee ee ee eee + 
FIRQB+FQFUN The function code DLNFQ (octal value = 6). 
FIRQB+FQPPN The PPN of the file to deleted. The project number is 
in the high byte (FIRQB+FQPPN+1), and the programmer 
number is in the low byte (FIRQB+FQPPN). A value of 
zero defaults to the PPN under which the calling 
program is running. 
FIRQB+FQNAM1 The name of the file to be deleted, as two words of 
RAD50 data. 
FIRQB+FQEXT The file type, as one word of RAD50 data. 


FIRQB+FQDEV 


FIRQB+FQDEVN 


Data Returned 


CALFIP 
DLNFQ 


The name of the device containing the file to be 
deleted, as two ASCII characters; it must be a disk or 
DECtape device. A value of zero in this word indicates 
the public disk structure (_SY:). 


The device unit number, in binary. A nonzero value in 
FQDEVN+1 indicates an explicit device unit number. A 
zero value in FQDEVN+1 indicates no unit number. 


Except for a possible error in byte 0 of the FIRQB, the DLNFQ function 
of CALFIP does not return any meaningful data. 


Errors 
NOSUCH 


PRVIOL 


Example 


The file specified in the data passed cannot be found. 


Protection violation. An attempt was made to delete a 
file that is either write-protected against the caller 
or marked for no delete. 


The following code deletes the file MYFIL.LST from the user’s account 
on the public structure. Assume that the FIRQB has been filled with 
zeros previously: 


MOVB #DLNFQ, FIRQB+FQFUN 

MOV #° RMYF, FIRQB+FQNAM1 ;SET FILE NAME 
MOV #° RILE, FIRQB+FQNAM1+2 ;AND TYPE 

MOV #° RLST, FIRQB+FQEXT ;TO "MYFILE.LST" 
CALFIP 


CALFIP 
ERRFQ 


ERRFQ (Return Error Message Text) 


Form/Example 
MOVB #ERRFQ, FIRQB+FQFUN 
MOVB #ERR, FIRQB+FQERNO 
Function 


The ERRFQ subfunction of CALFIP returns error message text from the 
system error message file or from the default error message file if an 
error message file is not currently installed. The text is associated 
with the value of the error code passed as byte 4 of the FIRQB. This 
call returns the full RSTS/E error message text associated with errors 
returned in byte 0 of the FIRQB on all the monitor directives. 


Privileges Required 


None 
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‘Data Passed 

Mne- Octal Octal Mne- 

monic Offset Offset monic 
L VSSAIIISIIIIIIAAAAIAAAAA AAAS S AAAS AA AAA SSAA \ 9 


FQOFUN 3 | ERRGF (= 14) VAAL 
DS ISSSSLLL1L11S11 1111117177 | error code | 4 FQERNO 


11 VW eaadaaaaiddiddda 10 


37 Cale Ae Ls AGE SAG A CREEK AMEE 36 


FIRQB+FQFUN The function code ERRFQ (octal value = 16). 


FIRQB+FQERNO The error code value (in binary) for which the 
corresponding error message text is to be returned. 


Errors 


The ERRFQ subfunction of CALFIP does not return any errors. 


CALFIP 
ERRFQ 


Data Returned 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tance nee ee ee ee ee eee eee + 
1 ee 0 
Se is + 
3 | KB*2(-KB*2+1l Aen job number * 2 | 2 FQJOB 
ten eee ee ee eee eee ee eee Sr + 
5 | | 4 FOFIL 
+ + 
7 | | 6 
+ + 
11 | | 10 
+ error message -- padded with nulls + 
13 | | 12 
+ + 
15 | to 28 characters (ASCII format) | 14 
+ + 
17 | | 16 
+ + 
21 | | 20 
+ + 
23 | | 22 
+ + 
25 | | 24 
+ + 
27 | | 26 
+ + 
31 | | 30 
+ + 
33 | | 32 
+ + 
35° | | 34 
+ + 
37 | | 36 
tee - ere ee eee ee ee eee teen cee ee eee ee ee eee eee + 

FIRQB+FQJOB The current job number times two. 

FIRQB+3 If the job is attached, two times the currently 
attached keyboard number. If the job is detached, the 
one’s complement of two times the currently detached 
keyboard number. For example, if the keyboard number 
is 5, the value in FIRQB+3 is: 12 for an attached job 
and 365 (377-12) for a detached job. 

FIRQB+FQFIL The error message text begins in this byte. The text 


is padded with zeros to 28 characters, if necessary. 


CALFIP 
LOKFQ 
LOKFQ (Disk File/Wildcard Lookup) 
Form 


MOVB #LOKFQ, FIRQOB+FQFUN 
(Set up FIRQB to define file/wildcard) 


CALFIP 
Function 
The LOKFQ subfunction of CALFIP does one of two actions: 


o Looks for a file on disk by name and returns directory 
information (date of creation, and so forth) 


o Performs a wildcard file search 


For example, with a file name and type in the FIRQB of *.TXT it 
searches an account for a file with any file name and a type of .TXT. 
By incrementing an index and reexecuting LOKFQ, you can search through 
an entire directory for all such files. 


Note 


For disk directory lookup on a PPN other than that of 
the caller, LOKFQ returns only files to which the 
caller has read or execute access. 


Privileges Required 


DEVICE to perform a disk directory lookup on the caller’s account if 
the referenced device is restricted. You need read or execute access 
(by protection code, GREAD, or WREAD) to perform a disk directory 
lookup on another account. 


CALFIP 
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Data Passed - 


Disk Directory Lookup 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tenn re ee eee ee ee ee ee eee terre eee eee ee ee eee eee + 
1 EE EEE A AIS REG GALA SALTS ABLE AANA A RE 0 
in i oe + 
FQFUN 3 | LOKFQ (= 22) VSLLSIILIILSA LPP LPY LL 2 
es te - 2 ee eee ee ee ee eee eee + 
5 | (must equal 177777 octal) | 4 FQFIL 
tere eee ee ee ee ee ee eee tee eee ee ee ee ee eee eee + 
ae) project number | programmer number | 6 FQPPN 
tee ee eee ee ee ee ee ee eee teen ee ee ee ee ee ee ee eee + 
11 | file name | 10 FQNAM1 
+ in RAD50 format + 
13 | (2 words) | 12 
t-- 2 ee eee eee ee ee ee eee fener ee eee eee ee eee eee + 
ES: | file type in RAD50 format (1 word) | 14 FQEXT 
es tern ee ee eee eee eee + 
17 AI AEA SEA SECA EE Alsi ALA 16 
Se ee ee + 
21 Vaeaddddaadiddda 20 
Hae ee ee ee epee ee ee ee ee ee ee eee eee + 
23 PS LLPPILLLTLPLISLAPPILPPTSPA TPP SLIPTAY SLI DT 22 
+---- ee eee eee ee eeeeeee ten ee eee ee ee ee eee eee + 
2D SSAA AAAS AAA AAAI AAA AAAS AAA AAA AAAS | 24 
t---- eee eee ee ee eee eee tore eee ee eee ee ee eee + 
27 eG ee 26 
i i irs + 
31 | device name (disk) ye ASCII characters) | 30 FQDEV 
t--- eee ee ee ee ee ee eee te - 2 eee eee ee ee eee eee + 
33 | #0, device no. real | device unit number | 32 FQDEVN 
tee eee eee ee ee eee eee eee Herne eee ee ee eee eee eee + 
35 UA EM RIG LEELA IS gil RL 34 
Sn no aa + 
37 Veda 36 
oe a a i ii ai ari + 

FIROB+FQFUN The function code LOKFQ (octal value = 22). 

FIRQB+FQFIL The word beginning at this location must be set to 
177777 (octal) to indicate the "disk directory lookup 
by file name" option of LOKFQ. 

FIRQB+FQPPN The PPN for the file to be looked up. A value of zero 
for this word defaults to the PPN under which the 
calling program is running. 

FIRQB+FQNAM1 The file name to be looked up; two words in RAD50 


format. 


CALFIP 
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FIRQB+FQEXT The file type of the file to be looked up; one word in 
RAD50 format. 


FIRQB+FQDEV The device name (must be disk), as two ASCII 
characters. If both bytes are zero, the public disk 
structure (SY:) is used. 


FIRQB+FQDEVN The disk device unit number is passed here in binary. 
A nonzero value in FQDEVN+1 indicates an explicit 
device unit number. A zero value in FQDEVN+1 indicates 
the system default. 


Data Returned ~ Disk Directory Lookup by File Name 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se Sl + 
LUSSSSISIAIIAIAIIT AIA AAI AAA AAA AAAI AA AAA AAAS | 9 
Si Herr err eee eee + 
ZS YSSISSSAISAILAASS STS | job number * 2 | 2 FQJOB 
t--- ee ee ee ee ee eee ee eee tere rer er re ee eee eee + 
5 | same as data passed (177777 octal) | 4 FQFIL 
te -- eee eee ee ee ee eee eee tee rc ee ee eee ee ee eee + 
7 | project number | programmer number | 6 FQPPN 
tree ree eee eee ee eee eee Herre rer ee eee ee eee + 
ll | file name in RAD50 format | 10 FQNAM1 
+ + 
13>. (2 words) | 12 
+----+---- weet ee eee eee tee ee eee ee eee ee eee + 
15 | file type in RAD50 format (1 word) 14 FQEXT 
tr rrr re eee ee ee ee ee eee Det + 
17 | LSB of file length in 512-byte blocks 16 FQSIZ 
terre er ee ee ee eee ee eee fee rc eee ee eee ee ee eee + 
21 | MSB of file length | protection code 20 FQNAM2 
tere ree eee eee eee ee eee tence eee eee eee eee + 
eo.) date of last access 22 FQMODE 
tee ee re ee ee ee eee eee peer e ee ee eee eee eee eee + 
ao i date of creation | 24 FQFLAG 
t---- eee wetter ee ee eee Se + 
27 | time of creation | 26 FQPFLG 
terre rr ee ee ee ee ee eee ten rte eee ee ee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
Sr ter cr err re eee eee + 
33 | #0, unit no. real | device unit number | 32 FQDEVN 
tence eee ee ee eee ee eee tee cnt ee eee ee eee eee + 
35°. || file clustersize | 34 FQCLUS 
0 terre rr ee ee eee eee + 
37 file identification index | 36 FQNENT 
Se Se + 
FIRQB+FQJOB The current job number times two. 
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FIRQB+FQFIL 


FIRQB+FQPPN 


FIRQB+FQNAM1 


FIRQOB+FOQEXT 


FIRQB+FQSIZ 


FIRQB+FQNAM2 


FIRQB+21 


FIRQB+FQMODE 


FIRQB+FQFLAG 


FIRQB+FQOPFLG 


FIRQB+FQDEV 


FIRQB+FOQDEVN 


FIRQB+FQCLUS 


FIRQB+FONENT 


The word at this location is the same as the data 
passed, in this case, 177777 (octal). 


The PPN of the file (same as data passed). 


The file name; two words in RAD50 format (same as data 
passed). 


The file type; one word in RAD50O format (same as data 
passed). 


The LSB of the file’s size in 512-byte blocks. This 
word is combined with the byte at FIRQB+21 to form a 
24-bit field giving the file size. 

The file’s protection code, is returned in 
this byte. 


in binary, 


The MSB of the file size in 512-byte blocks. It is 
combined with the word at FIRQB+FQSIZ to form a 24-bit 
field giving the file size. 


The date the file was last accessed, 
format: 


in system internal 


[(year - 1970) * 1000.) + day-within-year 


See the .DATE directive for a discussion of the system 
internal format for dates. 


The date the file was created, 
format (see FIRQB+FQMODE). 


in system internal 


The time the file was created, in system internal 
format: minutes until midnight, with 1440 equal to 
midnight. 


The device name, as two ASCII characters. Always a 
specific name, even if zero was passed here. 


The device unit number, in binary. A specific number 
is always returned here; FIRQB+FQDEVN+1 is always 
nonzero. 


The file cluster size is returned in this word. 


The file identification index is returned in this word. 
You can use the file identification index instead of 
the file name to open a file on disk with the OPNFQ 
subfunction of CALFIP. To do so, specify an explicit 
device name at FIRQB+FQDEV, a device unit number at 
FIRQB+FQDEVN, an explicit PPN at FIRQB+FQPPN, a zero 
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word at FIRQB+FQNAM1, and the file identification index 
at FIRQB+FQNAM1+2. (The file identification index is 
used by utilities that access software subroutines in 
the RMS libraries, for example.) 


Note that there is no performance gain in using the 
file identification index instead of the file name. 

The file identification index is provided for 
compatibility with RSX. Furthermore, the file 
identification index is changed when the REORDR utility 
is run on the directory (see the RSTS/E System 
Manager’s Guide). 


Errors 

BADNAM The file name in bytes FIRQB+FQNAM1 through FIRQB+13 is 
missing or invalid. 

NOSUCH The device specified at FIRQB+FQDEV is not disk, or the 
file specified does not exist on the specified disk. 
This error also occurs when a user does not have read 
or execute access to the specified file. 

Example 


The following code looks for the file MATRIX.DAT on the system disk: 


CALL CLRFQB ;CLEAR FIRQB 

MOV #LOKFQ, FIRQB+FQFUN ;SET FUNCTION CODE 
MOV #177777,FIRQB+FQFIL ;FILENAME LOOKUP 
CLR FIRQB+FQPPN ;CALLER’S ACCOUNT 
MOV #° RMAT, FIRQB+FQNAM1 ;SET FILENAME 

MOV #° RRIX, FIRQB+FQNAM1+2 ;AND TYPE 

MOV #° RDAT, FIRQB+FQEXT ;TO "MATRIX.DAT" 
CLR FIRQB+FQDEV ;SYSTEM DISK 

CLR FIRQB+FQDEVN ; DEVICE 

CALFIP 


See Programming Hints for information on the CLRFQB routine. 


CALFIP 
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Data Passed ~ Disk Wildcard Directory Lookup 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
teeter eee ee eee ee ee eee terre eee ee ee eee ee eee + 
1 a er 0 
Se ee ns + 
FQFUN 3 | LOKFQ (= 22) WLLL. 2 
Hence ee re ee ee ee eee eee Se 
5 | index: n means search for n+l occurrence H 4 FQFIL 
tener rr eee ee ee eee eee Sea + 
7 | project number | programmer number | 6 FQPPN 
Se terre eee eee ee ee eee eee + 
11 | wildcard file name | 10 FQNAM1 
+ specification in RAD50 format + 
13 | (2 words) | 12 
perc eee ee ee ee ee ee eee a + 
15 |wildcard file type in RAD50 format (1 word)| 14 FQEXT 
i + 
LV VSSASASIIIASA SSAA IAAI AAAS AAA AAA AAA AAA 1117 \ V6 
Se Se + 
21 UI SA la ie AEA tal SALAM A heled Miele 20 
Se ie + 
23 WE marked-for-delete | 22 FQMODE 
tee ee eee ee eee eee eee Se + 
25 SSSA IAAI AAAS AAA AA AAAS AAA | 24 
i Se + 
ZT VASA AAA AAA AA AAA AAA AAA A AAA AAA | 28 
Se Se + 
31 | device name (disk) (2 ASCII characters) | 30 FQDEV 
tere eee eee eee eee ee eee Se + 
33 | #0, device no. real | device unit number | 32 FQDEVN 
tener ee re ee ee ee eee eee Se + 
SO NSASSSISTAIISSISIIISS IAAT SAAT T AIA LI ASSIS AIST 7 34 
tener eee eee eee ee ee ee Sr + 
ST VSSSASIIIAIIAA AAA AIA AAAS AAA AAA AAA AAA AAAS | 36 
Se Se + 
FIRQB+FQFUN The function code LOKFQ (octal value = 22). 
FIRQB+FQFIL An index number specifying the occurrence of the file 


name meeting the wildcard specifications. A value of 
zero in this word causes the monitor to search for the 
first file name in the directory that meets the 
specification. A value of one causes the monitor to 
search for the second file name, and so forth. 


FIRQB+FQPPN The PPN of the account whose directory of disk files is 
to be searched. 


CALFIP 
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FIRQB+FONAM1 The wildcard file name; as two words in RAD50 format. 
Either an asterisk (*) character can replace the entire 
file name, or a question mark (?) character can replace 
any character in the file name. For example, a file 
name of FILE?? would cause the monitor to search the 
directory for any file name beginning with the 
characters FILE. An * character indicates that the 
file name does not matter in the search. 


FIRQB+FQEXT The wildcard file type; as one word in RAD50 format. 
An * character can replace the entire file type, or a? 
character can replace any character in the file type. 
For example, a file type of BA? causes the monitor to 
search the directory for any file type beginning with 
the characters BA. An * character indicates that the 
file type does not matter in the search. 


FIRQB+FQMODE If bit 14 is set, LOKFQ returns information about 
marked-for-delete files. 


FIRQB+FQDEV The name of the device to be searched (must be disk). 
A value of 0 in this word indicates the public disk 
structure (SY:). 


FIRQB+FQDEVN The device unit number in binary. A nonzero value in 
FIRQB+FQDEVN+1 indicates an explicit device unit 
number. <A zero value in FIRQB+FQDEVN+1 indicates the 
system default. 


CALFIP 
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Data Returned - Disk Wildcard Directory Lookup 


Mne- Octal 


monic Offset 


FIRQB 
Octal Mne- 
Offset monic 


+ == ess es = w= we we ww we eee ee swe wewebe we we we ew we we ew we ewe ee el lc Ul lL le le + 
1 VMI 0 
Se ae + 
3  PLILISAILIPT ALATA \ job number * 2 | 2 FQJOB 
Sr Se + 
iS: <i (as passed) | 4 FQFIL 
Se tere eee eee weer eee + 
7 | project number | programmer number | 6 FQPPN 
t--- 2 eee eee ee ee eee eee 5 + 
11 | file name in RAD50 fo caae | 10 FONAMI 
+ + 
13 | (2 words) [i b2 
Se Sr + 
15 | file type in RAD50 format (1 word) | 14 FQEXT 
t--- eee ee ee ee ee ee eee Se a + 
17 | LSB of file length in 512-byte blocks | 16 FQSIZ 
Herre e ree eee ee eee eee Se + 
21 | MSB of file length | protection code | 20 FQNAM2 
terre eee eee ee eee eee Se + 
23 date of last access (disk only) | 22 FQMODE 
tee ee ee ee eee eee eee t-- eee eee ee ee ee eee eee + 
25 date of creation | 24 FQFLAG 
t--- 2 - eee eee eee eee eee Se + 
27 time of creation | 26 FQPFLG 
tee eee ee eee eee ee eee i + 
31 | | 30 FQDEV 
+ (as passed) + 
33 | | 32 FQDEVN 
er tere ee eee ee eee ee ee eee + 
35° || file clustersize (disk only) | 34 FQCLUS 
ter eee ee ee ee eee eee te - ee ee ee ee ee ee eee eee + 
37 | USTAT byte ASIII IIIISL SSAA A111 7/7 \ 36 FQNENT 
Heer eee ee ee ee ee eee eo + 
FIRQB+FQJOB The current job number times two. 
FIRQB+FQPPN The PPN of the file (same as data passed). 
FIRQB+FQNAM1 The actual file name of a file meeting the wildcard 
specification in the data passed; two words in RAD50 
format. 
FIRQB+FQEXT The actual file type of a file meeting the wildcard 


specification in the data passed; one word in RAD50 
format. 


FIRQB+FQSIZ 


FIRQB+FQNAM2 


FIRQB+21 


FIRQB+FQMODE 


FIRQB+FOFLAG 


FIRQB+FQPFLG 


FIRQB+FQDEV 


FI RQB+FQDEVN 


FIRQB+FQCLUS 


FIRQB+FQNENT+1 


CALFIP 
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The LSB of the file’s size in 512-byte blocks. This 
word is combined with the byte at FIRQB+21 to form a 
24-bit field giving the file’s size. 


The file’s protection code, in binary, is returned in 
this byte. 


The MSB of the file’s size in 512-byte blocks. The 
byte is combined with the word at FIRQB+FQSIZ to give 
the file’s size. 


The date the file was last accessed, in system internal 
format: 


[(year - 1970) * 1000.] + day-within-year 


See the .DATE directive for a discussion of the system 
internal format for dates. 


The date the file was created, in system internal 
format (see FIRQB+FQMODE). 


The time the file was created, in system internal 
format: minutes until midnight, with 1440 equal to 
midnight. 


The device name, as two ASCII characters. Always a 
specific name, even if zero was passed here. 


The device unit number, in binary. A specific number 
is always returned here; FIRQB+FQDEVN+1 is always 
nonzero. 


The file cluster size is returned in this word. 


Internal flag information: 


Bit Meaning When Set 
1 File is placed 
2 Some job has write access now 
3 File is open in update mode 
4 File is contiguous; no extend allowed 
S No delete or rename allowed 
i) File is marked for deletion 
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Errors 


BADNAM 


NOSUCH 


PAKLCK 


Example 


No file specification appears at FIRQB+FQNAM] or the 
file name is invalid. 


Either the device specified at FIRQB+FQDEV and 
FIRQB+FQDEVN is not a disk, or no match exists for the 
occurrence specified in the word at FIRQB+FQFIL. 


The disk is restricted and the caller does not have 
DEVICE privilege. 


The following code asks the monitor to search the directory for 
account [2,130] for the first occurrence of a file specification 


beginning 


CALL 
CALL 
MOV 
MOV 
MOV 
-FSS 
MOVB 
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FILNAM: 
NAMSIZ 


with the letter X: 


CLRFQB ;MAKE SURE FIRQB 
CLRXRB ;AND XRB ARE CLEAR 
#FILNAM, XRB+XRLOC ;POINT TO FILE NAME 
#NAMSIZ,XRB+XRLEN ;SET ITS LENGTH 
#NAMSIZ,XRB+XRBC ;AND AGAIN 
;CONVERT TO FIRQB FORMAT 

#LOKFQ, FIRQB+FQFUN ;SET FUNCTION CODE 

-ASCII "[2,130]X?????.*" ;STRING FOR .FSS TO CONVERT 


- FILNAM ;AND ITS LENGTH 


See Programming Hints for information about the CLRFQB and CLRXRB 


routines. 
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OPNFQ (Open a File/Device on a Channel) 
Form 


MOVB #OPNFQ, FIRQB+FOQFUN 
(Set parameters appropriate to file or device) 


CALFIP 
Function 


The OPNFQ function has the same effect as an OPEN FOR INPUT statement 
in BASIC-PLUS; it opens a device or existing file on a channel. 
Parameters defining the device, file name and type, protection code, 
and mode are passed to the monitor in the FIRQB. If a file name is 
given in the FIRQB, a file-structured open for input is performed. If 
no file name is given, a non-file-structured open for input is 
performed. The RSTS/E Programming Manual describes file- and 
non-file-structured OPEN FOR INPUT statement and the actions taken for 
the mode parameter (MODE modifier in BASIC-PLUS) for each device. 


Note 


Privileges are required to open a disk for 
non-file-structured processing. Whenever you use a 
disk as a non-file structured device, be aware that 
all RSTS/E data structures you access are subject to 
change at any time. The same applies if you open a 
UFD as a file. 


Privileges Required 


No privileges are required to open the caller’s UFD for read-only 
access. Privileges are needed to perform the following: 


© GREAD to open the UFD of any other account in the caller’s 
group for read-only access 


Oo WREAD to open the UFD of any account outside the caller's 
group for read-only access 


o DEVICE to open a restricted device 


o Read access (protection code, GREAD, or WREAD) to open a disk 
file for read-only access 
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o Write access (protection code, GWRITE, WWRITE, and/or SYSIO) 
to open a disk file for write access 

Oo EXQTA to specify detach on close option on a pseudo keyboard 

o TUNE to select data caching mode on open 

o RDNFS to gain non-file-structured read access to a disk 


o SYSMOD to gain non-file-structured write access to a mounted 
disk 


o WRTNFS to gain non-file-structured write access to a disk, or 
to gain write access to a UFD 
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Data Passed 
_ -FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tee eee eee ee ee ee ee ee ee tee eee ee ee ee ee ee ee eee + 
1 NAGE Rd OD TRL eR es 0 
te me ee ee ee ee pee ee ee ee ee ee ee ee eee + 
FQFUN 3: i OPNFQ (= 2) VWPSPISLISIILPLSL LP LL 2 
tree ee ee ee ee ee ee ee eee t-- eee ee ee ee ee eee ee eee + 
SLSSSSSSSSS/111////////\ channel number * 2 | 4 FQFIL 
tern re er ee eee eee eee eee t--- eee ee eee ee eee eee + 
7 | project number | programmer number | 6 FQPPN 
tee ee eee ee ee ee ee ee eee Se + 
PL +t file name in RAD50 format | 10 FQNAM1 
+ + 
13 | (2 words) | 12 
+--- eee ee ee ee ee ee ee eee t--- ee ee eee ee ee eee eee + 
15 | file type in RAD50 format (1 word) | 14 FQEXT 
+e - eee eee ee ee ee ee ee eee t---- eee ee ee eee eee eee + 
17 | receive buffer size for DMC11/DMR11 | 16 FQSIZ 
terre ee ee eee ee ee ee eee tee eee ee eee ee ee ee eee + 
21 GLE SEEM AUREG LER ECHAG AA KAAA MEGA Eat 20 
tee ne ee pe ee ee ee ee ee ee ee eee + . 
23 | node | 22 FQMODE 
tee ee ee ee ee ee ee ee ee eee tee eee ee ee ee ee ee eee eee + 
25 |SSSSSSAISIAIIIAAAAIA AAAS A AAAS AS AAAS 24 
+-- 2 eee ee ee ee ee ee ee eee te --- eee ee ee eee ee ee eee + 
27 Ne a) 26 
Se i + 
Sale device name (2 aocis characters) | 30 FQDEV 
a +-------- eee eee ee eee ee + 
33° 4 Av unit no. real | device unit number | 32 FQDEVN 
tern ee eee ee ee ee eee eee +--+ - 2 eee ee ee ee eee eee + 
35 | no. rec. bfrs. to allocate for DMC1l1/DMR11| 34 FQCLUS 
tee ee ee eee ee ee ee ee eee terre eee ee ee ee ee eee eee + 
37 ELA A SAAR AMAA Aha ARAM AAA 36 
ee ei i i aie + 
FIRQB+FQFUN The function code OPNFQ (octal value = 2). 
FIRQB+FQOFIL Channel number times two; defines the channel on which 
the file is to be opened. 
FIRQB+FQPPN The PPN of the file to be opened. The project number 


is in the high byte (FQPPN+1), and the programmer 
number in the low byte (FQPPN). A value of zero 
defaults to the PPN under which the calling program is 
running. (Zero for non-file-structured open.) 
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FIRQB+FQNAM1 


FIRQB+FQEXT 


FIRQB+FQSIZ 


FIRQB+FQMODE 


FIRQB+FQDEV 


FIRQB+FQDEVN 


FIRQB+FQCLUS 


The file name to be opened; two words of RAD50 data. 
May also be specified as a zero word followed by the 
file identification index (see LOKFQ). 


(Must be two zero words for a non-file-structured 
open. ) 


The file type; one word of RAD50 data. (Must be zero 
for a non-file-structured open.) 


This parameter has the same function as the FILESIZE 
option in BASIC-PLUS. It is only used for the 
DMC11/DMR11, where it specifies the receive buffer 
size. ‘You can specify a value between 1 and 632 (1170 
octal). See the RSTS/E Programming Manual for more 
information. 


The mode with which the file is to be opened; values 
and actions taken are as described for the MODE 
modifier in OPEN FOR INPUT and non-file-structured OPEN 
statements for various devices, as described in the 
RSTS/E Programming Manual. If you use a mode value at 
all, you must set bit 15 of this word to l. 


The device name is passed here as two ASCII characters. 
A value of zero indicates "Sy", public disk. 


The device unit number is passed here in binary. A 
nonzero value in the high byte of this word 
(FIRQB+FQDEVN+1) indicates an explicit device unit 
number. <A zero value in FIRQB+FQDEVN+1 indicates no 
unit number. 


This parameter has the same function as the CLUSTERSIZE 
option in BASIC-PLUS. For OPNFQ, it is used only for 
the DMC11/DMR11, where it specifies the number of 
receive buffers to allocate. You can specify a value 
between 1 and 127, but values greater than four are not 
recommended. See the RSTS/E Programming Manual for 
more information. 


Data Returned 
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FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
teen ee ee ee ee eee ee eee t--- 2 ee eee ee ee ee ee eee + 
1 WT eG 0 
i ee as + 
3 PLLLILLILLALLAIP IIIT current job no. * 2 | 2 FQJOB 
5 tere eee ree re ee eee eee + 
FQOSIZM 5 | MSB of file size | channel no. * 2 | 4 FQFIL 
i t--- ee ee ee ee eee ee eee + 
7 | project number | programmer number | 6 FQPPN 
tener ee ee ee ee ee eee terre re ee ee eee ee eee + 
11 | file name in RAD50 format | 10 FQNAM1 
+ + 
13 | (2 words) | 12 
tee et eee eee ee eee ee eee Se + 
oa file type in RAD50 format (1 word) | 14 FQEXT 
t-- eee ee eee ee eee eee +e ee ee eee ee ee eee eee + 
17 | LSB of file size | 16 FQSIZ 
Se te -ee e e ee ee eee eee + 
22. | Peaconable buffer size for device | 20 FQBUFL 
terre te ee ee ee ee eee tenner ee eee eee eee ee eee + 
23 | (as passed) | 22 FQMODE 
tere ee ee ee ee ee ee eee tener ee ee ee ee eee eee eee + 
29... || device description | 24 FQFLAG 
Herr ee ee ee ee eee ee eee tere ree eee ee eee eee eee + 
FQPROT 27 | protection code | clustersize, mod256 | 26 FQPFLG 
fern tee ee eee ee ee eee tere nee ee ee ee ee eee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
tee ee ee ee ee ee eee eee terre rer ee eee ee ee ee eee + 
33° || flag byte | device unit number | 32 FQDEVN 
fern re ee eee ee ee ee ee eee t--- eee ee eee ee eee ee eee + 
35° .\| file tener index | 34 FQCLUS 
ie ae + 
37 V7 eaaadaaaaadaadiadida 36 FQNENT 
Se ee es + 
Note 
For nondisk devices, the relevant information 
returned with the OPNFQ subfunction is in the two 
words at FIRQB+FQBUFL and FIRQB+FQFLAG. All other 
words are returned as passed. 
FIRQB+FQJOB The current job number times two. 
FIRQB+FQFIL Channel number times two; defines the channel on which 


the file is open. 
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FIRQB+FQSIZM 


FIRQB+FQPPN 


FIRQB+FQNAM1 
FIROB+FQEXT 


FIRQB+FQBUFL 


FIRQB+FQFLAG 


FLGFRC 
FLGKB | 
FLGRND |_| 


Be eal 
15 14 13 


FLGPOS | 
FLGMOD 


Me 

| 
| | 
ae 
1211-10 


For large disk files (greater than 65,535 blocks), this 
byte contains the MSB of the file’s size in 512-byte 
blocks. This byte is combined with the word at 
FIRQB+FQSIZ to form a 24-bit field giving the file 
size. 


The PPN under which the file is open. An actual PPN is 
returned here even if this word was passed as zero. 


The file name; two words of RAD50 data. 
The file type; one word of RAD50 data. 


Reasonable buffer size for this device, in bytes. If 
you are doing device-independent I/0 (that is, if you 
do not want to keep track of which device is being 
opened and perform specific opens, reads, and writes, 
depending on the device), this value is the monitor’s 
best guess for a buffer size to use in subsequent reads 
and writes on the opened channel. (See the .READ and 
WRITE directives. ) 


Description of the device just opened. The low byte 
contains the device’s handler index. There is one 
unique handler index for all device types. The high 
byte contains a set of status flags to allow for 
device-independent I/O routines. 


a. 
| 


High Byte - Device-Type Flags 


The bits in the high byte of the flags word are set to 
indicate the type of file or device just opened. 
FLGRND 1 The device or file is random-access. 
0 The device or file is sequential. 


FLGKB = 


FLGFRC = 


FLGMOD = 


FLGPOS = 


DDWLO = 


DDRLO = 


DDNFS = 


Low Byte 
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The file or device is a terminal-type file 
or device (or is generically a terminal). 

The file or device is not a terminal-type 

file or device. 


The file or device is byte-oriented. That 
is, the .READ and .WRITE directives handle 
data in byte units. 

The file or device is block-oriented. The 
-READ and .WRITE directives handle data in 
block units. 


The file or device accepts modifiers in 
-READ and .WRITE directives. 

The file or device does not accept modifiers 
in .READ and .WRITE directives. 


The file or device keeps track of its 
horizontal position and expands characters 
such as TAB into whatever is appropriate for 
the file or device. You can determine the 
current horizontal position with the .POSTN 
directive. 

The file or device does not keep track of 
its horizontal position. 


The file or device has been write-locked 
(with the protection code or mode value in 
the open) or is generically a read-only 
device. 

The file or device is not write-locked. 


The file or device has been read-locked 
(with the protection code in the open) or is 
generically a write-only device. 

The file or device is not read-locked. 


The file or device is non-file-structured 
(or is generically not a file-structured 
device). 

The file or device is file-structured. 


Device Handler Index 


Bits 0-7 of the flags word contain a handler index that 
indicates the generic kind of device. The currently 
defined values follow. 
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FI RQB+FQPFLG 


FIROB+FQPROT 


FIRQB+FQDEV 


FIRQB+FQDEVN 


FIRQB+33 


FIRQB+FQCLUS 


t------- terre eee Here eee ee ee ee ee ee eee ee ee ee eee + 
| Octal | | | 
| Value | Symbol | Meaning | 
+------- +--- ee eee tee eee ee ee ee ee ee ee eee + 
0 DSKHND All disks 
2 TTYHND All terminals 
4 DTAHND | DECtape 
6 LPTHND All line printers 
10 PTRHND Paper tape reader 
12 PTPHND Paper tape punch 
14 CDRHND Card reader 


| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
8 | Se 
| 16 | MTAHND | Magnetic tape | 
| | | Pseudo keyboards | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 


20 PKBHND 
22 RXDHND Flexible diskettes 
24 RJEHND 2780 remote job entry 
26 NULHND The null device 
30 DMCHND The DMC11/DMR11 DDCMP interface 
36 Reserved 
40 KMCHND KMCl1 
42 IBMHND IBM interconnect 
46 DMPHND DMP11/DMV1l1 device 
t------- +e------- ten ee ne ee eee ee ee ee ee ee eee eee + 


The file cluster size, modulo 256. That is, a file 
cluster size of 256 is indicated a zero. 


The protection code of the file. 


The device name; two ASCII characters. (For disk, the 
actual device name is returned, even if a zero word was 
passed in this word.) 


The device unit number. (For disk devices, the actual 
unit number is returned here, even if FIROQB+FQDEVN+1 
was passed as zero.) 


For a file-structured open, this byte contains two 
relevant bits: 


Bit 0 = 0 The device is in the public structure 
Bit 0 =1 The device is a private disk 

Bit 1 = 0 A specific device was not specified 
Bit 1 =1 A specific device was specified 


These bits are meaningless for a non-file-structured 
open. 


The file identification index of this file. This word 
is significant mainly in that it can be used in place 
of the file name in subsequent opens of the file on 
disk. You can open the file with the OPNFQ subfunction 
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Errors 


NOTCLS 


PRVIOL 


XXXXX 


Example 
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by using an explicit PPN in FIRQB+FQPPN, a zero word in 
FIRQB+FQNAM1, and the file identification index in 
FIRQB+FQNAM1+2. 


Note that there is no performance gain in using the 
file identification index instead of the file name. 

The file identification index is provided for 
compatibility with RSX. Furthermore, the file 
identification index is changed when the REORDR utility 
is run on the directory (see the RSTS/E System 
Manager’s Guide). 


The specified channel is already open. It must be 
closed before it can be opened again. 


You do not have the necessary privilege and you tried 
tos 


o Open a disk for non-file-structured access. 


o Open a device that the system manager has 
restricted to users with DEVICE privilege. 


All other possible errors are device-dependent. See 
Appendix A for a full list of errors. 


The following MACRO code sets up the FIRQB for the OPNFQ function. A 
non-file-structured open of magnetic tape unit 2 is done on channel 3: 


MAG: -ASCII MT 
CALL CLRFQB ;CLEAR FIRQB 
MOVB #OPNFQ, FIRQB+FQFUN ;SET FUNCTION CODE 
MOVB #3*2,FIRQB+FQFIL ;SET CHANNEL = 3 
MOV MAG , FIRQB+FQDEV ;SET DEVICE = MT 
MOVB #377,FIRQB+FQDEVN+1 ;SET FLAG DEVICE NO. EXPLICIT 
MOVB #2,FIRQB+FQDEVN ;SET DEVICE NO. = 2 
CALFIP 


See Programming Hints for information on the CLRFQB routine. 
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RENFQ (Rename a File) 
Form 


MOVB #RENFQ, FIRQB+FOQFUN 


(Define file to be renamed and new name in FIRQB) 
CALFIP 
Function 


The RENFQ function renames an existing file on disk or DECtape and, if 
requested, deletes any existing file with the new name. 


Privileges Required 
DEVICE is required if the device is restricted. Create/rename access 


(GWRITE, WWRITE, and/or SYSIO) to rename a disk file outside the 
caller’s account. SYSIO to set the privilege bit (bit 7 in FQPROT). 
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/ Data Passed 
FIRQB 
Mne- Octal Octal. Mne- 
monic Offset Offset monic 
teen ee eee ee ee ee ee ee eee te - ee eee ee ee ee eee eee + 
1 Re EE ee 0 
Se + 
FQFUN Sf RENFQ (= 10) Wen 2 
tern eee ee ee ee ee eee eee te - 2 ee ee ee ee ee ee ee eee + 
SD WALLS ALISA AAAS S A TATA IAAT AAT ATLAS AAAS TST. 38 
Se te -- ee eee eee ee ee ee eee + 
7 | project number | programmer number | 6 FQPPN 
tere eee ee ee ee ee ee ee eee teen en re ee ee eee eee eee + 
11 | file name | 10 FQNAM] 
+ in RAD50O format + 
13 | (2 words) | 12 
tee ree ee eee ee ee ee ee eee eS + 
LS. || file type in RAD50 format (1 word) | 14 FQEXT 
terre ee eee eee eee eee eee as + 
17 | -l1 to delete existing file (disk only) | 16 FQSIZ 
teen ee ee ee eee ee eee eee tee ee eee ee ee eee ee ee eee + 
21 | new file name | 20 FQNAMI 
+ in RAD50 format + 
23 | (2 words) | 22 
terre eee ee ee eee eee eee + 
25 | new file type in RAD5SO format (1 word) | 24 FQFLAG 
tern ete eee ee eee eee eee terre ee ee ee ee ee ee eee + 
FQPROT 27 | file protection | = 0 if no change | 26 FQPFLG 
tern ee ee ee ee ee eee ee eee tere ee eee ee ee ee eee + 
31 | device name (disk) (2 ASCII characters) | 30 FQDEV 
tenner eee ee ee ee ee ee eee terre re eee ee eee ee eee + 
33 | #0, device no. real | device unit number | 32 FQDEVN 
tenner ee ee ee ee ee ee eee terre ee ee ee eee ee eee + 
35 MALE RA ANAL AERA AREER 34 
+ - ws ee ww eee wwe ewe wD we ew ew web ew ew we we we ee ew we el Be ee le ele + 
37 Vad 36 
+ sees ese we wee ew ewww Bee wwe wee we ween ec ew we ew see eww wwe ee es we ws & + 
FIRQB+FQFUN The function code RENFQ (octal value = 10). 
FIRQB+FQPPN The PPN of the existing file to be renamed. The 


project number is in the high byte (FIRQB+FQPPN+1), and 
the programmer number is in the low byte (FIRQB+FQPPN). 
A value of zero defaults to the PPN under which the 
calling program is running. 


FIRQB+FQNAML1 The old (existing) name for the file; two words of 
RAD50O data. 


FIRQB+FQEXT The old (existing) type for the file; one word of RAD50 
data. 


3-83 


CALFIP 
RENFQ 


FIRQB+FQSIZ 


FIRQB+FQNAM2 


FIRQB+FQPROT 


FIROQB+FQDEV 


FIRQB+FQDEVN 


Data Returned 


This word is set to -1 to indicate that any existing 
file on the specified device with the new name is to be 
deleted. If any other value is given here and a file 
already exists with the new name, the RENFQ function 
will return an error. 


The new file name and type; three words of RAD50 data. 
You can use RENFQ to change the protection code on a 
file by setting FQPROT and making these three words the 
same as the three words beginning at FIRQB+FQNAMI. 


The new protection code for the file, if any, is 
specified in this byte. To retain the old protection 
code, this entire word (FIRQB+FQPFLG and FIRQB+FQPROT) 
must be zero. If the word is nonzero, the high byte 
will be used as the new protection code. 


The device name is passed here as two ASCII characters. 
It must be a disk or DECtape device. A value of zero 
in this word indicates the public disk structure 
(_SY:). 


The device unit number is passed here in binary. A 
nonzero value in FIRQB+FQDEVN+1 indicates an explicit 
device unit number. A zero value in FIRQB+FQDEVN+1 
indicates the system default. 


Other than a possible error in byte 0 of the FIRQB, the RENFQ function 
of CALFIP does not return any meaningful data. 


Errors 


FIEXST 


NOSUCH 


The new file name specified already exists. 


The old file specified cannot be found. 
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‘Example 
The following code renames the file OLDNAM.TXT to NEWNAM.TXT on the 


public disk structure under the caller’s account. FQSIZ is set to -l, 
so any existing file named NEWNAM.TXT is deleted: 


CALL CLRFQB ;CLEAR FIRQB 

MOVB #RENFQ, FIRQB+FQFUN ;SET FUNCTION CODE 
MOV #° ROLD, FIRQB+FQNAM1 ;SET OLD FILE NAME 
MOV #° RNAM, FIRQB+FQNAM1+2 ;AND TYPE 

MOV #° RTXT, FIRQB+FQEXT ;TO "OLDNAM. TXT" 

MOV -#-1,FIRQB+FQSIZ ;DELETE EXISTING FILE 
MOV #° RNEW, FIRQB+FQNAM2 ;SET NEW FILE NAME 
MOV #° RNAM, FIRQB+FQNAM2+2 ;AND TYPE 

MOV #° RTXT, FIRQB+FQNAM2+4 ;TO “NEWNAM. TXT" 
CALFIP 


See Programming Hints for information about the CLRFQB routine. 
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RSTFQ (Reset a Channel) 
Form 


MOVB #RSTFQ, FIRQB+FQFUN 


(Define channel to be reset) 


CALFIP 
Function 


The RSTFQ function closes a channel, all channels, or all channels 
except one without performing any of the normal clean-up operations. 
For example, no trailer tape is written to paper tape punch; no form 
feed is given on the line printer; and no trailer labels are written 
to magnetic tape. This function is useful as a backup to a normal 
close operation. If a normal close fails, RSTFQ will close the 
channel regardless. You can also use RSTFQ to closes a channel on 
which a tentative file is open if you do not want to make the file 
permanent. The RSTFQ directive functions the same as a CLOSE 
statement with a negative channel number in BASIC-PLUS. See the 
RSTS/E Programming Manual for description of tentative files. 


Privileges Required 


None 
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Data Passed 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 OLEACEAE 0 
FOQFUN ca RSTFQ (= 20) VYIPILIILILIILILL ILD 2 
) WOOO channel number * 2 | 4 FQFIL 


7 GEE 6 
11 MOIRA C CELT EL OEE RELLY 10 


FIRQB+FQFUN The function code RSTFQ (octal value = 20). 
FIRQB+FQFIL The value is set as follows: 


o To reset one channel, set FIRQB+FQFIL to the 
channel number to reset times two 


o To reset all channels, set FIRQB+FQFIL to zero 
o To reset all but one channel, set FIRQOB+FQFIL to 


-(channel number times two); that is, the negative 
of two times the channel number to remain open 
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-CCL 


eCCL - Check String for CCL Command 
Form 

CCL 
Function 


The .CCL directive asks the monitor to check a string (defined in the 
XRB) to see if it is a valid Concise Command Language (CCL) command. 
If the string is a valid CCL command, the monitor passes control to 
the appropriate run-time system for that CCL (as defined by the system 
Manager), using the equivalent of a .RUN directive. If the directive 
is successful, control does not return in line. 


Control passes to the run-time system at the location specified in the 
P.RUN word in the pseudovector region (Chapter 2). Data in the job’s 
CORCMN, XRB, FIRQB, and KEY areas in the low segment are passed to the 
run-time system because they are of interest to the run-time system 
being entered as a result of a .CCL, not to the caller. The file 
containing the program to be run as a result of the .CCL command is 
opened on channel 15. See Chapter 2 for a description of these areas 
in the P.RUN word. 


If the string is not a valid CCL command, the monitor returns control 
to the caller (the run-time system or user job image that issued the 
-CCL directive) with no error. Control resumes with the instruction 
following the .CCL. Since control would not be returned here 
otherwise, the program does whatever housekeeping it deems necessary 
here for an unsuccessful CCL. 


The system manager defines the CCL command, an abbreviation point, the 
name of the file that is to be executed when the command is given, and 
an entry point for the program (see the RSTS/E System Manager’s 
Guide). 


The command can be a string from one to nine characters long. The 
allowed single-character commands are A through Z, @, S$, and #. 
Commands that are longer than one character must begin with a letter; 
the remaining characters can be letters or digits. 


The abbreviation point defines how many characters must be specified 
before the command is accepted as valid. For example, if "DIRECTORY" 
were defined as a CCL command, the system manager could indicate three 
characters as the abbreviation point for the command. Then DIR, DIRE, 
DIREC and so forth, up to the full DIRECTORY, would all be interpreted 
by the monitor as correct CCL commands. (The monitor always fills in 
the full CCL command in CORCMN when it passes control to the 
appropriate run-time svstem. ) 


-CCL 


When you issue a .CCL directive, the monitor compares the indicated 
string with the commands defined by the system manager: 


o All null (ASCII code 000) and delete (ASCII code 177) 
characters are ignored and are never passed on to the 
run-time system in CORCMN. 


o ASCII code 200 is ignored and is never passed on to the 
run-time system in CORCMN. 


o Leading spaces (ASCII code 040) and tabs (ASCII code 011) are 
ignored and are never passed on to the run-time system in 
CORCMN. 


o When not enclosed by the quote characters " (ASCII code 042) 
and ’ (ASCII code 047): 


- All tabs (ASCII code 011) are changed to spaces (ASCII 
code 040). 


- All control characters (ASCII codes 001 through 037, 
inclusive, and ASCII codes 201 through 237, inclusive) 
are ignored and never passed in CORCMN. 


- Adjacent spaces (ASCII code 040) are merged into a single 
space. 


- All lowercase alphabetics (ASCII codes 141 through 172, 
inclusive, and ASCII codes 341 through 376, inclusive) 
are changed into their uppercase equivalents (ASCII codes 
101 through 132, inclusive, and ASCII codes 301 through 
336, inclusive). 


o When enclosed by the quote characters " (ASCII code 042) and 
’ (ASCII code 047), all characters are kept as is and passed 
on to the run-time system in CORCMN. 


Immediately following the CCL command text (for example, DIR/SI:n/DET) 
the monitor also analyzes two switches. These switches are passed on 
to the run-time system as status flags set in the XRB (See the P.RUN 
description in Chapter 2). The two switches may appear in either 
order, but must immediately follow the command. Both are optional 
switches. 


The /SIZE switch has the format: 

[space]/SI[Z[E]]:[+][(#]n[.] 

where n indicates the size, in K words, of the user job image that the 
program, when executed, will require. If the + sign is given, n 


indicates the additional amount of space, in K words, that the file 
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will require over that indicated by the computed size or minimum size 
(see the description of the PF.CSZ bit in P.FLAGS word, Chapter 2). 
If the + sign is omitted, then n simply indicates the size, in K 
words, at which the invoked file should run. If the # sign is given, 
n is assumed to be octal. If the period (.)is given, n is assumed to 
be decimal. If both are given, an error is returned, and if neither 
is given, n is assumed to be decimal. The value of n must be between 
l and the system-wide maximum for a user job image (see the SWAP MAX 
discussion in the RSTS/E System Installation and Update Guide). 


The /DETACH switch has the format: 
[space] /DET[A[C[H]]] 


This switch indicates that the invoked program should be run detached. 
In this state, channel 0 (the terminal associated with the job) is 
marked as detached while the program is running. This switch is 
useful for noninteractive programs; it frees the terminal for other 
use and prevents the user from interrupting the job by entering a 
CTRL/C. 


Remember that the monitor simply examines these switches and passes 
the information on to the run-time system. The run-time system is 
responsible for doing the appropriate processing. For more 

information on the CCL facility, see the RSTS/E Programming Manual. 


Note 
Do not use this directive from a user job image 
running under the RT11l run-time system, since the 
lowest 512. bytes are used by RT11l differently from 
other run-time systems. Instead, use .DOCCL (See 
Chapter 7). 
Privileges Required 


Execute access (by protection code, GREAD, or WREAD) is needed to 
execute a program for a CCL command. 
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Data Passed 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre een eee ee eee eee tenn eee ee ee eee eee eee + 
1 | length of proposed command string, bytes | 0 XRLEN 
pre rr eee ee eee Se + 
3 | length of proposed command string, bytes | 2 XRBC 
Sl Se + 
| Stare ing address . command string | 4 XRLOC 
Se i aes + 
7 Vad 6 
Si a + 
ll | | 10 XRBLK 
+ (passed to + 
£3: || new run-time system | 12 
+ unaltered) + 
15 | | 14 
i tere ere ret ee ee ee eee + 
XRB+XRLEN The length of the proposed CCL command string, in 
bytes. 
XRB+XRBC The length of the proposed CCL command string, in 
bytes, is also passed in this word. 
XRB+XRLOC The starting address of the proposed CCL command 
String. (See the section "XRB (Transfer Request 
Block)" in Chapter 2 for more information. ) 
XRB+XRBLK The remaining three words are unaltered here if the 


string is indeed a CCL command and the monitor takes 
over and does the equivalent of a .RUN directive. That 
is, the run-time system that is given control as a 
result of this command finds the same three words here 
that the caller left. These three words are also be 
unchanged if control returns back to the caller for any 
reason. See the .RUN monitor call in this Chapter and 
the P.RUN entry point in Chapter 2 for details. 


Data Returned 


No useful data is returned to the calling program. (The P.RUN 
description describes the data passed to the run-time system if the 
call is successful.) If the call is unsuccessful, the last three words 
of the XRB are unaltered, but the first four words are random. In 
addition, an error code is returned in the first byte of the FIRQB. 


~CCL 


Errors 

(none) No error is returned if the command part of the string 
passed was not a valid CCL command. The contents of 
CORCMN have not been altered; the XRB (except for the 
last three words) has been altered. 

BADCNT The first three words of the XRB, which describe the 
CCL command string, are illegal. 

BADSWT An illegal switch was given in the CCL command string. 

BDNERR An illegal number was the argument to one of the 
Switches found in the CCL command string. For example, 
the n value in the /SIZE switch was greater than the 
system-wide maximum for a user job image (see the SWAP 
MAX discussion in the RSTS/E System Installation and 
Update Guide). 

LINERR The indicated string is too long to be passed in 
CORCMN. 

XXXXXX Any other error returned results from the monitor’s 
execution of a .RUN directive for the program. See the 
.-RUN directive in this chapter. 

Example 


The following example asks the monitor to check a 72-byte string 
beginning at location BUFFER to see if it is a CCL command: 


BUFFER: .BLKB Tes 


CALL CLRXRB 


; Clear XRB 
MOV #72.,XRB+XRLEN ; Set length 
MOV #72.,XRB+XRBC ; Set length again 
MOV #BUFFER,XRB+XRLOC ; Set starting address 
-CCL 


See Programming Hints for information on the CLRXRB routine. 


- CHAIN 


-CHAIN ~- Execute Under Same RTS 
Form 

. CHAIN 
Function 


The .CHAIN directive is the same as the .RUN directive, except that it 
returns an error if the program to be run would cause a new run-time 
system to be entered. That is, if the call succeeds, the current 
run-time system is entered at the P.RUN entry point (see Chapter 2). 
In addition, there is no change in the user job image size. 

Otherwise, the error code NORTS is returned in byte 0 of the FIRQB. 


Use this call to bypass the special protection afforded by the 
compiled-file bit in the protection code. The run-time system can use 
this directive to access an executable file without the problem of 
possibly losing control (unlike .RUN, which can transfer control to a 
different run-time system). The .CHAIN directive reenters the 
run-time system so a user cannot take control of the file once it is 
open on channel 15. 


See the .RUN directive, for Data Passed, Data Returned, and Errors. 
For the example, substitute .CHAIN for .RUN. 


Note 
Do not use this directive from a user job image 
running under the RT11l run-time system. Use the RT11l 
.-CHAIN directive (see Chapter 7) to transfer control 
to another program running under RT1ll. 


Privileges Required 


Execute access (by protection code, GREAD, or WREAD) is required to 
execute a program. 


- CLEAR 


~CLEAR - Clear Keyword Bits 
Form 
. CLEAR 
Function 
Use the .CLEAR directive to clear certain bits in the keyword (KEY) 
location in the user job image. The XRB passes the bits to be cleared 
to the monitor. 
Privileges Required 
None 


Data Passed 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tee eee eee eee ee ee ee eee Hee eee eee ee ee ee ee ee eee + 
1 | bits to be cleared are set to l here | O XRLEN 
tere rte ee ee ee eee ee eee tere ee ee ee ee ee ee eee eee + 
3B SSSI AIAAAAAAAIA AAAS AAAS AAAS SAAS AAS 4 2 
terre eee ee eee ee eee eee Fete ee ee ee ee eee ee ee eee + 
be) I LESLIE UL I 4 
tern ee ee ee ee ee epee ee ee ee ee ee ee eee + 
7 Veda 6 
ee Sos + 
11 PP PLSPLLPLSPLPLALLSILLLSAPLSPPASPAPLA PSA Y 10 
tere nee ee ee ee ee ee ee eee pene eee ee eee eee ee ee eee + 
L3 (SSSI IIIISISAAAAAAAA AAAS AAA AAA AA AAA AAA \ 2 
tee eee ee ee et ee ee ee eee peer ree ee ee ee ee ee eee + 
15 TEAL EIA CAAA A AAU EERE RNA RAH 14 
ter ee ee ee epee ee ee ee ee ee eee + 
XRB+XRLEN The bits to be cleared are set to l here. 
JFSPRI--------- + 
JFFPP--------- + | 
JFPRIV------- + | | 
JFSYS------- + | | | 
JFNOPR----- + | | | | 
JFBIG----- + | | | | | 
JFLOCK- - -+ | | | | | | 
| | | | | | | 
15 14 13 #12 #11 #10 9 8 | 7 6 5 4 3 2 1 0 
ee ee Sen Sn ee eee en ee ee ee en ee ei. Se Seas 
| | | | | | | | | | | | | | | | 
SS i i Cie Soi Se Se ee Oe eS ee oe ee oe oe ees 
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JFBIG 


JFNOPR 


JFSYS 


_ JFPRIV 


JFFPP 


JFSPRI 


» CLEAR 


Clearable by any caller. Clearing JFLOCK indicates 
that the job wants to be swapped. When JFLOCK is 
clear, the monitor swaps the job (that is, the user job 
image) to and from disk as necessary. 


Not clearable by any caller; masked off. That is, the 
corresponding bits in KEY cannot be cleared by the job 
with the .CLEAR directive. 


Not clearable by any caller; masked off. 


Clearable by any caller. If the job has temporary 
privileges and this bit is cleared in a .CLEAR call, 
the temporary privileges are temporarily lost. 


If a .CLEAR directive is issued with this bit indicated 
for clearing, any temporary privileges that the job has 
or had are permanently lost. 


Clearable by any caller. Clearing JFFPP indicates that 
this job no longer wants the state of the hardware 
floating-point unit (if any) to be swapped along with 
the job’s normal context information. 


Clearable by any caller. Clearing JFSPRI lowers the 
job’s run priority by one-half step. That is, it 
clears bit 2 of the system- controlled low-order three 
bits of the run priority. See the SET JOB command 
RSTS/E System Manager’s Guide. 


All other bits in the XRB are masked off. 


Data Returned 


The .CLEAR directive does not return any meaningful data. 


Errors 


No errors are possible with the .CLEAR directive. 


Example 


The following code clears the JFLOCK bit: 


CALL 
MOV 


. CLEAR 


CLRXRB ;CLEAR XRB 
#JFLOCK,XRB+XRLEN ;SET JFLOCK FOR CLEAR 


See Programming Hints for information on the CLRXRB routine. 
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~CMDLN - Read/Write Command Line 
Form 
. CMDLN 
Function 
The .CMDLN directive lets programs pass up to 1K words of data (2048 
characters) when chaining to another program. DCL uses this 
capability to pass long command lines to some server programs. If 
possible, the .CMDLN directive stores the data in core common. If 
not, it stores the data in XBUF. 
Note 

The read function deletes the command line after it 

has been read, therefore the command line can only be 

read once. 
Privileges Required 


None 


Data Passed (Write a Command Line) 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tee - eee ee ee ee ee eee eee terre ee ee ee ee eee + 
1 | length of command line to write | O XRLEN 
terre ee ee ee eee tee ee ee ee ee ee eee eee + 
3. | length of command line to write | 2 XRBC 
t--- eee eee ee ee eee eee tence er re re ee ee eee + 
5: ‘| address of command line to write | 4 XRLOC 
Sl | + 
7 OO IT OTT ORE CO 6 
Se i + 
11 VL eaadaaaaadiadidida 10 
Se i a ie + 
13 PLPILILLIPTILILLILTTPLELALALL IPA TL ILD ALALE 12 
Se Set + 
VS YSASSSSSASISSSI AISA AAAI AAAS AAAS AAAS 7 \ 494 
5 i i + 
XRB+XRLEN The length of the command line to be written, in bytes. 
XRB+XRBC The length of the command line to be written, in bytes. 
XRB+XRLOC The starting address of the command line to be written. 


(See the section "XRB (Transfer Request Block)" in 
Chapter 2 for more information. ) 
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BADCNT 


NOBUFS 


- CMDLN 


XRB parameters were invalid, or the command line was 
too long. 


Not enough XBUF was available to store the command 
line. 


Data Passed (Read a Command Line) 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
to -e ete ee ee ee ee ee ee eee t---- ee ee ee ee ee eee eee + 
1 | length of buffer to receive command line | 0 XRLEN 
ter nr rr ee ee ee ee eee eee +e -- ee eee re ee eee ee eee + 
3° zero | 2 XRBC 
| Sl + 
Sil address to aa command line | 4 XRLOC 
Se ee + 


7 LPIPILILI IL ILILILILD LL UL ILIA ITAL TLDAT ILE 6 
11 CEERI AGMA CREEL HAASE I EA ARMAS 10 
13 UZ 12 
15 LPILLLT LILI ILL ILL IP ILIA ULI ED ILI D UL 14 


XRB+XRLEN 


XRB+XRBC 


XRB+XRLOC 


Data Returned 


XRB+XRBC 


Errors 


NOSUCH 


LINERR 


The length of the buffer to receive the command line, 
in bytes. 


Zero to indicate a read operation. 
Starting address of the area where the command line is 


placed. (See the section "XRB (Transfer Request 
Block)" in Chapter 2 for more information.) 


The length of the command line read, in bytes. 


There was no command line to be read. 


The command line was too long for the user’s buffer. 


- CORE 


~CORE ~- Change Memory Size 
Form 

- CORE 
Function 
The .CORE directive asks the monitor to change the amount of memory 
currently allocated for the user job image (low segment) for this job. 
The monitor preallocates space for a user job image at the time a .RUN 
directive is issued. The space is based on the size of the file (if 
PF.CSZ = 1 in the P.FLAG word of the pseudovector region) or is equal 
to the P.MSIZ word in the pseudovector region. 


Note 


If the I&D space split is enabled, .CORE alters only 
the size of the D-space. 


You can change this initial size with the .CORE directive as many 
times aS you want, as long as the requested size: 


o Falls within a maximum and minimum value 
o Does not overlap any address windows created by the job for 
use with resident libraries (see the .PLAS directive in this 


chapter) 


The monitor first checks the size requested against maximum and 
minimum values, using this algorithm: 


Sa + 

lKword < P.MSIZ < | size requested | < private < P.SIZE < system 
| with .CORE | maximum maximum 
tener et eee ee eee + for job 


The monitor determines the maximum allowable amount of space for a 
user job image as follows: 


o Set <max> (the maximum size that a job image can be) to the 
system-wide maximum. This maximum is set by the system 
manager at startup time (see the SWAP MAX discussion in the 
RSTS/E System Installation and Update Guide). 


o If the maximum user job image size imposed by the run-time 
system (P.SIZE in the pseudovectors) is less than the current 
<max>, set <max> to P.SIZE. 


o If the job’s private memory maximum is less than <max> and if 
the caller does not have EXQTA privilege, then set <max> to 
the job’s private memory maximum. The system manager can set 
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a particular job’s private memory maximum with the SET 
JOB/SIZE=n command. You can also set a private memory 
maximum with the UU.PRI subfunction of the .UUO directive (in 
this chapter). A job’s private memory maximum is initially 
defaulted to the system maximum. 


o The size of I-space and the size of D-space can not exceed 
32K words each. 


Thus, the size requested with .CORE is checked against <max>, as 
determined by the four previous steps. The size requested with .CORE 
is also checked against a minimum (the P.MSIZ word in the pseudo 
vectors, which must be greater than or equal to 1K words). Any size 
between P.MSIZ and <max>, inclusive, is legal. 


There are two special cases: 


o If the size requested with .CORE is exactly equal to the 
run-time system’s minimum size (P.MSIZ), that request is 
considered legal even if the requested size is greater than 
the job’s private maximun. 


o If the size requested with .CORE is less than the job image’s 
current size and within the allowable bounds for the run-time 
system, but it is still larger than the private maximum, that 
request is considered legal. This could happen if the caller 
had EXQTA privilege, allowing the current size to be greater 
than the private maximum, and then dropped EXQTA privilege. 
The monitor would still allow the size greater than the 
private maximum. 


If .CORE requests a decrease in job image size, no further checks are 
made. If .CORE requests an expansion and the size is legal according 
to the cases previously described, the monitor then checks the base 
APRs of any address windows created by the job (see the CRAFQ 
subfunction of .PLAS in this chapter). Windows created by the CRAFQ 
subfunction of .PLAS require both I&D APRs for mapping. Therefore, if 
a task contained 20K words of I-space and 16K words of D-space, only 
12K words is available for windows. If the size requested in the 
.CORE overlaps a created address window, the .CORE fails and returns 
an error. 


If .CORE requests a legal expansion that cannot be made in place, that 
is, if there is not enough free memory available for the expansion, 
the job is swapped out and swapped back in at the larger size. (This 
Swap occurs even when JFLOCK = 1 in the keyword (KEY).) 


When a user job image expands, the content of the newly added memory 


1s zeroed as protection against a malicious user reading memory to 
look for passwords. 
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Note 
Do not use this directive from a user job image 
running under the RT1ll run-time system. Expanding 
memory size should be done through the RT11 emulator, 
using the appropriate RT1l1l directive. 
When the image runs under the RSX run-time system, use the EXTKS 
directive to extend the task size, so that subsequent GTSKS directives 
can return the task size correctly. 
Privileges Required 
EXOQTA to exceed private memory maximum. 
Data Passed 
XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 | Ié&D flag |desired size, K words| 0Q XRLEN 
an AMA he 
a AAA: 
VAAL hhh 
Ahhh 
L3 |SSSSASSSSSIIAASS IIASA AAA AAI AAAS AAA AAS \ 12 


LS USSSA SIISLAASSS ISAS ASAI ISSA AAAS ISAS S171 | 4 


Se tone ee ere ee eee eee eee + 

XRB+XRLEN The desired size for the user job image, in K words. 

XRB+XRLEN+1 If this byte contains a -l, the user is requesting that 
the I&D APRs be split to map different physical memory. 
XRB+XRLEN is the requested size of the D-space. The 
I-space size is fixed at the job’s current size. 


If this byte contains a -1 and XRB+XRLEN contains a 
zero, the I&D split is disabled. 


Data Returned 


Other than a possible error in the byte 0 of the FIRQB, the .CORE 
directive does not return any meaningful data. 
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Errors 

EDBMCE The requested user job image size is illegal. It is 
either too large or too small, or it overlaps a mapped 
window. 

ERRERR The program is requesting use of separate I&D space but 
the hardware does not exist on this system. 

INUSE There is outstanding asynchronous I/O for this job. 

Example 


The following code requests a user job image of 24K words: 


CALL CLRXRB ;CLEAR THE XRB 
MOVB #24.,XRB+XRLEN ;SET XRB TO INDICATE 24K WORDS 
- CORE 


See Programming Hints for information on the CLRXRB routine. 
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~-DATE - Return Current Date and Time 
Form 
- DATE 
Function 
The .DATE directive returns the current date and time, the current 
program name (as installed by the .NAME directive), and the current 
run-time system name in the XRB. 
Privileges Required 
None 
Data Passed 


The .DATE directive does not pass any meaningful data. 


Data Returned 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tee e ree ee eee eee ee eee ee + 
1 | current date, in system internal format | 0 XRLEN 
Se terre eee eee eee ee eee eee + 
a4 Minutes until midnight | 2 XRBC 
tener rn ee ee eee ee eee eee Herre ee eee ee ee eee eee + 
5 | ticks until second | seconds until minute| 4 XRLOC 
Herr re ee ee ee eee ee eee terre er ee ee eee ee eee eee + 
7 | program name in RAD50 format | 6 XRCI 
+ (2 words) + 
11 | (as installed with .NAME) | 10 
terre ee ee ee eee ee eee eee teen eee ee eee ee eee eee + 
13 | run-time system name in RAD50 format | 12 XRTIME 
+ (2 words) + 
ae | 14 
teeter ee ee ee eee eee tee ee ee eee eee ee eee eee + 
XRB+XRLEN The current date, in system internal format. The 


monitor calculates the date as: 

[(year - 1970) * 1000] + (day-within-year ) 
where day-within-year is 1 for January 1, 2 for January 
2, and so forth. (Every leap year, the day-within-year 


value for March 1 and following is one higher than in 
other years.) 
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XRB+XRBC 


XRB+XRLOC 


XRB+5 


XRB+XRCI 


XRB+XRTIME 


Errors 


-DATE 


The number of minutes until midnight. A value of 1440 
is midnight; 720 is noon; 0 is never returned. 


The number of seconds until the next minute. A value 
of 60 is xx:xx:00; 1 is xx:xx:59; 0 is never returned. 


The number of ticks until the next second. A tick is 
either 1/60th or 1/50th of a second, depending on the 
clock in use and/or the line frequency. (Systems 
running with the KW11P clock at crystal speeds, rather 
than at line frequency, have a tick of 1/50th of a 
second. Otherwise, if the system is operating with a 
60 Hz power line, a tick is 1/60th of a second.) 


The current program name (as set by the most recent 
»NAME directive); two words in RAD50 format. 


The current run-time system name; two words in RAD50 
format. 


No errors are possible with the .DATE monitor call. 


Example 


Since no data is passed to the monitor, the call is: 


. DATE 
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-ERLOG -- Log an Error from RTS 
Form 

- ERLOG 
Function 
You can issue the .ERLOG directive only from the high segment 
(run-time system). It allows the run-time system to log an error into 
the RSTS/E error log file, which can then be printed by the system 
manager (see the RSTS/E System Manager’s Guide). For example, you 
might want to place an entry into the RSTS/E error logging scheme on a 
hardware floating-point unit exception that has an illegal error code 
because the monitor makes no such checks. 
You can issue this directive only from the job’s current run-time 
system (high segment). Since this call does not require privilege, 
the monitor does not to let users fill up the system error log with 
unimportant errors. If .ERLOG is issued from the user job image (low 
segment), RSTS/E ignores it. 
Privileges Required 
None 
Data Passed 
The .ERLOG directive records in the system error log file the contents 
of the program counter (PC) and program status word (PS) at the time 
of the call, as well as the contents of the general registers (RO 
through R5). These registers will then be,displayed at the system 
manager’s request. Hence, the registers should contain whatever 
information you want to record when the .ERLOG is executed. 
Data Returned 
The .ERLOG directive does not return any meaningful data. 
Errors 
No error is possible with .ERLOG. 
Example 


If the general registers contain relevant information, the call is: 


- ERLOG 
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EXIT - Exit to Default Keyboard Monitor 
Form 

~EXIT 
Function 
The .EXIT directive returns control to the system default keyboard 
monitor (DCL) at the P.NEW entry point (see Chapter 2). When a 
program exits, it normally passes control to the job’s keyboard 
monitor with the .RTS directive. You can use the .EXIT call as a 
backup to return control to the default keyboard monitor if the .RTS 
fails, or for any other reason when you want to enter the default 
keyboard monitor at the entry point specified by P.NEW. The .EXIT 
directive needs no arguments and never returns in line to the caller. 
Privileges Required 
None 
Data Passed 
The .EXIT directive needs no arguments; however, the three words 
beginning at XRB+10 are passed unaltered to the default keyboard 
monitor. The monitor also passes information to the default keyboard 
Monitor when .EXIT is executed. See the discussion of the P.NEW entry 
point in Chapter 2. 


Data Returned 


The .EXIT directive does not return any meaningful data; control never 
returns in line. 


Errors 

No errors are possible with .EXIT. 

Example 

Since no data is passed or returned with .EXIT, the call is; 

EXIT 
Note 

Do not use this RSTS/E directive from a user job 
image running under the RT11 run-time system. The 
correct way to terminate such a program is to exit to 


the RT11 emulator, which then returns control to the 
job’s keyboard monitor. 
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-FSS ~- Check File Specification String 
Form 

-FSS 
Function 
The .FSS directive examines a string of characters presumed to be a 
file specification and, if possible, converts it to the internal 
RSTS/E file specification format (FIRQB format). The monitor returns 
information to the XRB describing what it found in the string and 
returns the converted file specification to the FIRQB. Thus, programs 
that manipulate files can use .FSS to translate a user-typed string to 
the FIRQB format. 


The monitor examines the string from left to right and stops without 
error when it finds: 


o The end of the string. 

o An equal sign (=), which is ASCII code 075. 

o A semicolon (;), which is ASCII code 073. 

o A slash (/), which is ASCII code 057, that is followed by 
anything other than the following switches, which the monitor 
translates to the FIRQB format: 

- /CL{USTERSIZE]:[-][#]n[.] 
where n is the cluster size used in opening files and 
devices. The variable n can specify a value ranging from 
-32768 through 32767. 

- /MO[DE):[(#)]n[.] 


where n is the mode used in opening files and devices. 
The variable n can specify a value between 0 and 32767. 


- Y/FI[LESIZE):(#)]n[.] or /SI[ZE):[#)n[.] 
where n is the filesize used in opening files and 
devices. The value of n defines the file’s size in 
512-byte blocks and can be in the range 0 to 8,388,607 
blocks. 

- /PO[SITION]):n 
where n is the position used in creating files (to 
position block 1 of the file at a device cluster). The 


variable n can specify a value between -2 and 65,535. 
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- Y/PR[OTECTION]:[#]n[.] 


where n is the protection code used in opening or 
creating files. The variable n can specify a value 
between 0 and 255. The value of n determines the file’s 
protection from users; see the RSTS/E System User’s 
Guide. ‘ 


The brackets ([ ]) in the previous switches enclose optional 
characters. Where more than one character is enclosed in 
brackets, any or all of the enclosed characters can be 
omitted. For example, MO, MOD, and MODE would all be 
accepted and the following quantity translated to the mode 
location in the FIRQB. 


The value n is assumed to be decimal, unless the optional 
pound sign [#] appears, indicating that n is octal. The 
optional decimal point also indicates a decimal value. 


o A comma (,), which is ASCII code 054. An exception is the 
comma separating the project and programmer numbers in a PPN. 


The monitor translates the components in a file specification string 
as follows: 


device name A device name can be either a logical device name or a 
physical device name: 


logical A logical device name is a string of 
alphanumeric characters or $ terminated with 
a colon (:). The logical name can contain 
the $ character anywhere except as the first 
character. Only the first nine characters 
are examined; the remainder are ignored. If 
the logical name does not contain a $ 
character, the monitor checks the name 
against the user’s own logical device name 
assignments in USRLOG (or its equivalent, as 
defined in the XRB). If the monitor finds a 
definition, it returns the physical device 
name associated with that logical device name 
to the FIRQB. If the logical name is not 
found in the user-logical area or if the 
logical name contains a $ character, the 
monitor makes a search of system-wide logical 
names. If the logical name is not found, the 
monitor returns the logical device name and 
sets a flag in the XRB to indicate that it 
could make no association. For a logical 
device name beginning with an underscore (_), 
the monitor does not attempt any translation 
to a physical device name. 
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physical 


A physical device name consists of two 
alphabetic characters optionally followed by 
digits and ended with a colon (:). The 
digits are translated as decimal and must 
have a value between 0 and 127 (decimal). 
Leading zeros are allowed. 


For some devices (for example, terminals) a 
physical name can also be specified as a 
two-letter device name, a one-letter 
controller identifier, and a number 
specifying the unit on that controller. For 
example, TTG2: is the third terminal on a 
DZ11 controller. 


account or PPN A PPN can be expressed either as a single special 
character or as two separate numbers enclosed in square 
brackets ([]) or parentheses () and separated by a 


comma. 


The following special characters are translated as: 


The dollar sign ($) is equivalent to [1,2]. 


The exclamation point (!) is equivalent to 
[i433 


The percent sign (%) is equivalent to [1,4]. 
The ampersand (&) is equivalent to [1,5]. 


The number sign (#) is translated to the 
caller’s group library. It is always 
equivalent to [proj,0] where proj is the 
project number of the user issuing the .FSS 
directive. 


The at sign (@) is translated to the caller's 
assignable PPN, the USRPPN value (see Chapter 
2). If USRPPN is set, its value is placed in 
the FIRQB at offset FOQPPN. If USRPPN is 
zero, a string with an @ causes an error. 


Note 


DIGITAL does not recommend the use of 
the special characters !, %, &, #, or 
@. They are provided only for 
compatibility with pre-v9.0 releases 
of RSTS/E. 
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[n,m] This is the explicit construct for a PPN. 
The value n specifies the project number, and 
m specifies the programmer number. The 
variables n and m can specify any value from 
0 through 254, except for [0,0]. If a number 
sign (#) precedes either n or m, the string 
is assumed to specify an octal value. Either 
n or m, or both, can also be the asterisk 
(*). The * is converted to 255 and placed in 
its corresponding FIRQB location. The 
asterisk character indicates a wildcard 
specification. 


Either n or m, or both, can be omitted; in 
that case, the monitor uses the corresponding 
part of the user’s PPN. For example, [,] or 
{] specifies the user’s PPN; [,0] is 
equivalent to #. 


(n,m) This is an alternate way to specify an 
explicit PPN. The same rules for n and m 
apply as when they are enclosed by brackets. 


Note 


DIGITAL does not recommend the use of 
parentheses in the PPN specification. 
This format is provided only for 
compatibility with pre-v9.0 releases 
of RSTS/E. 


A file name can consist of alphanumeric characters and 
the question mark (?). It is the only field in the 
file specification with no explicit delimiter. Only 
the first six characters are examined; the rest are 
ignored. The asterisk character (*) is also an 
acceptable file name. It is translated to two words of 
RAD50, where each RAD50O character is the unused code 
(29). Each ? character is also converted to this 
unused code. This indicates that the file name field 
is a wildcard. (The LOKFQ subfunction of CALFIP and 
UU.LOK subfunction of .UUO can be used to look up 
wildcard files.) 


A file type can consist of alphanumeric characters and 
the ? character, preceded by a . character. The * 
character is also an acceptable file type. It is 
translated to one word of RAD50, where each RAD50 code 
is the unused code (29). Each ? character in the file 
type is also converted to this unused code. This 
indicates that the file type field, or character in the 
file type field, is a wildcard. 
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If given, the file type must always follow the file 


name. 
protection A file protection code can consist of numeric digits 
code enclosed by angle brackets (<>). The general form of a 


protection code is <nnn>, where n may be numeric 
Characters indicating a value from 0 through 255. If 
the numeric characters are preceded by a # character, 
they are converted as specifying an octal value. 
Alternatively, the protection code can be specified 
using the /PROTECTION switch. If no file protection 
code is specified in the string and a default value has 
been assigned in USRPRT (see Chapter 2), the default 
value is placed in the FIRQB. 


These special characters can appear in the string in any order, with 
the exception of the file type and PPN. The file type must follow the 
file name, if specified. 


In addition, if the device name is a system or user logical device 
name that has an account (PPN) associated with it, the position of an 
explicit PPN in the file specification string is significant. If the 
order is device:{PPN], then the explicit PPN overrides the PPN 
associated with the logical device name. If the order is 
[PPN])device:, RSTS/E displays the error message ?Illegal device name. 


Note 
Do not use this directive from a user job image 
running under the RT1ll run-time system, since the 
user logical area is not in the standard location. 


Privileges Required 


None 
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Mne- Octal 
monic Offset 


ug 


3 


5 


15 


XRB+XRLEN 


XRB+XRBC 


XRB+XRLOC 


XRB+XRBLK 


XRB+XRTIME 
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XRB 
Octal Mne- 
Offset monic 
wee eee ee eee eee ten ne er ee ee ee ee ee ee et 
length of the string, bytes | O XRLEN 
wee tee ee ee ee ee ee eee So 
length of the string, bytes | 2 XRBC 
we ee ee ee eee ee ee eee ten rn re ee ee eee et 
starting address of the string | 4 XRLOC 
wee ee ee eee eee eee So 
Zaidi 6 
wee ee eee ee ee ee eee ro 
renge of nonstandard user defaults | 10 XRBLK 
ee oe ee | 
scarring address of nonstandard users | 12 XRTIME 
wee ee ee ee ee ee ee eee 5 2 
GR Le Ae Fe 14 


The length of the character string to be translated, in 
bytes. 


The length of the character string to be translated, in 
bytes. 


The starting address of the string to be translated. 
(See the section "XRB (Transfer Request Block)" in 
Chapter 2 for more information. ) 


If the user logical information (USRPPN, USRPRT, and 
USRLOG) is in its standard location, this word is 
passed as zero. If some nonstandard set of locations 
is being used, then the length of that information, in 
bytes, is specified here. 


If the word at XRB+XRBLK is nonzero, then this word 
defines the starting location for the user logical 
information. (The order of the information is assumed 
to be the same as in its standard location; that is, 
the user logical PPN, user logical protection code, 
user logical device name table. The format is also 
expected to be the same (see the USRPPN, USRPRT, and 
USRLOG descriptions in Chapter 2 for details). 
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Data Returned 


Mne- Octal 
monic Offset 


1 


3 


L5 


XRB+XRBC 


XRB+XRLOC 


XRB+XRBLK 


Bit 


XRB 
Octal 
Offset 
Herter eee eee eee Hern ee ee ee eee eee + 
Aa aE ARSE A CAO AA EL HURL A AAA AL 0 
Si ia + 
|number of uneeaneiated characters in string| 2 
Se tere eee eee ee ee eee eee + 
| address of first eee ee character | 4 
Se ei + 
VM LLL 6 
Se ie + 
| flag word 2 | 10 
re terre ee ee ee eee eee + 
| flag word 1 | 12 
Se Si + 
| device description | 14 
tere eee ee ee ee eee eee Se + 


Mne- 
monic 


XRBC 


XRLOC 


XRBLK 


XRTIME 


XRMOD 


A count of the untranslated characters in the string. 
If all characters were translated, the value of this 


word is zero. 


The address of the first untranslated byte of the 
String. If XRB+XRBC is zero, this word identifies the 
end of the string. (See the section "XRB (Transfer 
Request Block)" in Chapter 2 for more information. ) 


Bit flags describing the translated string. 
this word is the same as "flag word 2" for the 
(see the 


BASIC-PLUS file name string scan SYS call 


RSTS/E Programming Manual). 


Setting Meaning 


Note that 


Set A file name was found in the source string; two 


words in RAD50 format at FIRQB+FQNAM1. 


Clear No file name was found (and bits 1 and 2 of this 


word are also 0). 


Set The translated file name consisted of a single * 
character and has been translated to two words at 
FIRQB+FQNAM1 consisting of the RAD50 


representation of the string "??????" 
Clear The translated file name was not an * character. 
Set The file name contained at least one ? character. 
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Bit 


10 


ll 


Setting 
Clear 
Set 


Clear 


Set 


Clear 


Set 


Clear 
Set 
Clear 
set 


Clear 


Set 


Clear 


Set 


Clear 
Set 
Clear 


Set 


-FSS 


Meaning 
The file name did not contain any ? characters. 
A period (.) was found in the source string. 
No period was found, implying that no file type 
was specified (and bits 4, 5, and 6 of this word 


are also 0). 


A file type was found; that is, the field after 
the period was not null. 


No file type was found (the field after the 
period was null), and bits 5 and 6 of this word 
are also 0. 

The file type was an * character and is returned 
in the word at FIRQB+FQEXT as the RAD50 
representation of the string "???". 

The file type was not an * character. 

The file type contained at least one ? character. 
The file type did not contain any ? characters. 


A PPN was found in the source string. 


No PPN was found (and bits 8 and 9 of this word 
are also 0). 


The project number was an * character. That is, 
the PPN was of the form [*,n]. RSTS/E returns a 
value of 377 at FIRQB+FQPPN+1. 

The project number was not an * character. 

The programmer number was an * character. That 
is, the PPN was of the form [n,*]. RSTS/E returns 
a value of 377 at FIRQB+FQPPN. 

The programmer number was not an * character. 

A valid protection code was found. 

No protection code was found. 

No file protection code was found in the string, 
but there was a default output file protection 
code in location USRPRT. The default has been 
returned in the FIRQB. 
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Bit Setting Meaning 


Clear The user-assignable default protection code (at 
location USRPRT) was not used. Either zero or the 
protection code given in the string is returned 
to the FIRQB. 


12 Set A colon (:), but not necessarily a device name, 
was found in the source string. 


Clear No colon was found (no device was specified) ; 
bits 13, 14, and 15 of this word are also 0. 


13 Set A device name was found in the source string. 


Clear No device name was found; bits 14 and 15 of this 
word are also 0. 


14 Set The device name in the string was a logical 
device name. 


Clear The device name in the string was an actual 
device name; bit 15 of this word is also 0. 


15 Set This bit set indicates an invalid device name. 
(The characters that were specified are simply 
returned at FIRQB+FQDEV, FIRQB+FQDEVN, and 
FIRQB+FQFLAG as three words in RAD50 format. ) 
This bit can be set in one of two ways: 


o If the device name contained an underscore 
but was not a recognizable device name for 
any device on the system, this bit is set. 


o If the device name did not contain an 
underscore but the name could not be 
translated to a physical device name, this 
bit is set. 


Clear The device name specified, if any, was either an 
actual device name or a logical device name to 
which a physical device has been assigned. The 
physical device name has been returned to the 
word at FIRQB+FQDEV as two ASCII characters, and 
the unit information has been returned 
appropriately at FIRQB+FQDEVN. 
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Bit 


8 


10 
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Remaining bit flags describing what was translated. 
Some of these bits duplicate information returned at 
XRB+XRBLK. DIGITAL recommends that you use the bits at 
XRB+XRBLK to allow for enhancements in future releases. 
Note that this word is the same as "flag word 1" for 
the BASIC-PLUS file name string scan SYS call, see the 
RSTS/E Programming Manual. 


Setting 


Set 


Clear 


Set 


Clear 


Set 


Clear 


Set 


Clear 


Set 


Clear 


Set 


Clear 


Set 


Clear 


Meaning 
The /CLUSTERSIZE:n switch was specified. 
The /CLUSTERSIZE:n switch was not specified. 


Either the /MODE:n or /RONLY switch was 
specified. 


Neither the /MODE:n nor the /RONLY switch was 
specified. 


The /FILESIZE:n or /SIZE:n switch was specified. 


Neither the /FILESIZE:n nor the /SIZE:n switch 
was specified. 


The /POSITION:n switch was specified. 

No /POSITION:n switch was specified. 

(Not currently used. ) 

A file name was found in the source string; two 
words in RAD50 format at FIRQB+FQNAM1. Note that 
this is the same meaning as for bit 0 at 
XRB+XRBLK. 

No file name was found in the source string. 

A period (.) was found in the source string. Note 
that this is the same meaning as for bit 3 at 


XRB+XRBLK. 


No period was found in the source string, 
implying that no file type was specified either. 


A PPN was found in the source string. Note that 
this is the same meaning as for bit 7 at 
XRB+XRBLK. 


No PPN was found. 
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Bit 


sal 


12 


13 


14 


15 


XRB+XRMOD 


Setting 


Set 


Clear 


Set 


Clear 


Set 


Clear 


Set 


Clear 


Meaning 


A valid protection code was found. Note that this 
is the same meaning as for bit 10 at XRB+XRBLK. 


No protection code was found. 


A colon (but not necessarily a device name) was 
found in the source string. Note that this is the 
same meaning as for bit 12 at XRB+XRBLK. 


No colon was found, implying that no device could. 
have been specified. 


Device name was specified and was a logical 
device name. Note that this is the same meaning 
as for bit 14 at XRB+XRBLK. 


Device name (if specified) was an actual device 
name. (If device name was not specified, this bit 
is also 0.) 


(Not currently used.) 


Source string contained wildcard characters 
(either ?, *, or both) in file name, type, or PPN 
fields. In addition, the device name specified, 
although a valid logical device name, does not 
correspond to any of the logical device 
assignments currently in effect or contains an 
underscore as the first character. Flag word 2 
contains more specific information. 


None of the above. 


The device description (the same information returned 
by the BASIC-PLUS STATUS variable and returned at 
FIRQB+FQFLAG when a file or device is opened with the 
OPNFQ or CREFQ subfunctions of CALFIP). The device 
handler index is in the low byte and descriptive flags 
are in the high byte. 
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FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
| i 5 + 
1 LUMA READ HAAR E ALLA Ll 0 
a + 
3  PSLISLILLIPLILTIPPILN current job no. * 2 | 2 FQJOB 
Herne ee ee eee eee tere re ee ee re ee eee eee + 
FOSIZM 5 | MSB of file size WAAL 
ter ree ee ee eee tore e re ee ee eee eee eee + 
7 | project number | programmer number | 6 FQPPN 
terre eee ee ee ee ee eee Sl + 
11 | file name in RAD50 format | 10 FQNAM1 
+ + 
Ls. : (first 2 words) | 12 
Horr re ee ee ee eee St + 
15 | file type in RAD50 format (1 word) | 14 FQEXT 
Sn re Se + 
17 | LSB of file size | 16 FQSIZ 
Se 6 + 
21 ERIE AG Ml OAK IAE ALLER CRG LAR ERAN SG 20 
Se a eas + 
23 | mode Sar eees | 22 FQMODE 
tre crete eee eee eee eee Se + 
25 | 3rd word of logical name (not translated) | 24 FQFLAG 
Hort re eee eee eee eee tee een eee ee ee eee eee eee + 
FQPROT 27 | protection code | =255, explicit prot.| 26 FQPFLG 
Se tener ree ee eee eee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
Herre ee ee ee ee eee terre ee ee ee eee eee eee + 
33 | #0, unit no. real | device unit number | 32 FQDEVN 
Se toe - er ere eee eee eee eee + 
35> 4 cluster size parameter | 34 FQCLUS 
Se tee eee eee ee eee eee eee + 
37 | position parameter (DCN for first block) | 36 FQNENT 
Hone ee ee eee eee +e -- eee ee eee eee eee eee + 
Note 


FIROB+FQJ 


FIRQB+FQS 


For each of the following field definitions that 
begin with the word "If," a corresponding statement 
applies: "If not, the field is left alone." That is, 
you can insert values in the FIRQB before executing 
the .FSS to serve as default values for fields when 
the .FSS returns no result. 


OB The current job number times two. 
IZM If a /FILESIZE:n or /SIZE:n switch was specified, the 


most significant bits of the file size are contained in 
this byte. 
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FIRQB+FQPPN 


FIRQB+FQNAM1 


FIRQB+FQEXT 


FIRQB+FQSIZ 


FIRQB+FQMODE 


FIRQB+FQPFLG 


FIRQB+FQDEV 


FIRQB+FQDEVN 


If a PPN was 
logical name 
user logical 
contains the 
number is in 
the low byte. 


the high byte; 


part of the translated string or if a 

was found to be the same as a system or 
name with an associated PPN, 
binary value of that PPN. 


this word 
The project 
the programmer number in 


Any value returned here by .FSS has been 


verified by the monitor as being within the range for 


PPNS on a RSTS/E system. 


If a file name was encountered, 
words of RAD50, beginning at this location. 


than 6 characters, the file 
padded with blanks (0 RAD50 


If a file type was encountered, 


word of RAD50, beginning at 
than 3 characters, the file 
padded with blanks (0 RAD50 


If a /FILESIZE:n or /SIZE:n 
value of n is translated to 


value are placed in this word. 


the byte at FIRQB+FQSIZM. 


If a /MODE:n switch was encountered, 


it is translated to two 
If less 
name is left-justified and 
characters). 


it is translated to one 
this location. If less 
type is left-justified and 
characters). 


switch was encountered, the 


binary and the LSB of the 
The MSB are placed in 


the value 


specified is translated to binary and returned in this 


word. 


Bit 15 is set to indicate that a mode switch was 


translated and to differentiate between a mode of 0 and 


no mode at all. (Note that 


mode value to work on opens. 


If a file protection code was encountered, a 
The high byte (FIRQB+FQPROT) 
binary value of the protection code, and the 
Setting the low byte 


returned here. 


(FIRQB+FQPFLG) is 255. 


bit 15 must be set for a 
) 


word is 
is the 
low byte 
indicates 


that a protection code was specified and differentiates 
a protection code of zero from no protection code at 


all. 


If a device name was specified, 
If less than two characters were 
the device name is left-justified and padded 


two ASCII characters. 
specified, 
with spaces (ASCII 32.). 


it is returned here as 


If a device name but no explicit unit number was 


specified, 
number was specified, 


this word is zero. 
then that unit number is in the 
low byte and 255 is in the high byte. 


If an explicit unit 


Setting the high 


byte indicates an explicit device number and 
differentiates a device number of zero from no device 


number at all. 
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FIRQB+FQNENT 


Errors 


BADCNT 


BADNAM 


BADSWT 


BDNERR 


-FSS 


Note 


If a syntactically correct logical device name 
was encountered that could not be translated to 
a physical device name, then the first six 
characters of the logical device name is 
returned as two words of RAD50 starting at 
offset FQDEV and the next three characters are 
returned as one word of RADS50 at offset FQFLAG. 
A status bit in the XRB is set to indicate that 
this was done. 


If a /CLUSTERSIZE:n switch was encountered, the value 
of n is returned here, in binary. 
If a /POSITION:n switch was encountered, the value of n 


is returned here, in binary. (The value n is the 
device cluster number for the first block of the file.) 


The first three words of the XRB are illegal, or an odd 
or illegal address for nonstandard user logical table. 


Some illegal specification occurred in the string. 
-FSS found a sign bit set on at least one character. 


Some .FSS switch was encountered, but it was in an 
illegal format. 


The numeric argument to one of the .FSS switches was 
illegal. 
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Example 


The following code causes the monitor to scan a string beginning at 
location BUFFER as a possible file name. BUFFER is defined as an 
80-byte area and is filled with zeros to terminate the string scan if 
what the user typed did not £1ill the buffer. For example: 


BUFFER: .» BLKWO 40. 


(read string into BUFFER from terminal) 


CALL CLRXRB 

MOV #80.,XRB+XRLEN ;DEFINE LENGTH 

MOV #80.,XRB+XRBC ;DEFINE LENGTH AGAIN 
MOV #BUFFER,XRB+XRLOC ;START OF BUFFER 
-FSS 


(test for error; if none, try open) 
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LOGS - Check for Logical Device Names 
Form 
. LOGS 
Function 
The .LOGS directive: 


o Translates a system logical device name to a physical device 
name 


Oo Verifies that a physical device name is valid 
o Obtains generic information about a particular device 


You specify either a logical device name, a physical device 
designation (name and, if relevant, unit number), or both, in the XRB 
and the FIRQB. The monitor compares the logical device name 
specified, if any, against the system-wide logical device names 
defined by the system manager. (This directive does not check 
user-specified logical names.) If it finds a match, the monitor 
returns the device designation associated with the logical device name 
to the FIRQB. This physical device designation consists of a name, 
unit number, and in some cases, a PPN. 


Next, the monitor checks the physical device designation (either the 
one passed or the one returned by the monitor in the logical-name 
translation) to be sure it is valid. If so, information describing 
the device is returned in the FIRQB. 

Privileges Required 


None 
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Data Passed 


Mne- Octal 
monic Offset 


13 


15 


XRB+XRLEN 


XRB 
Herre eee ee eee eee terre re eee eee eee eee + 
| logical device name in RAD50 format | 
+ (3 words) + 
| | 
+ + 
| | 
5 Si + 
WEEE 


a Ahhh 
WALA hhh 
aw AA hhh 
WAAL hh 
a AM hhh hhh 
WAAL hhh 


Octal Mne- 
Offset monic 


0 XRLEN 


2 


4 


12 


14 


The logical device name to be checked is passed as two 
words in RAD50 format beginning at this location. If 
only a physical device name check or description is 
needed, then the first word of the XRB should be passed 
as zero. The physical device name is passed in the 


FIRQB. 
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FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tert eee ee ee ee ee ee ee eee ten ee ee ee ee eee ee eee + 


1 


3 


37 


VL 0 
| LIMA BLESS ENA TEAL ASAE 2 


| physical device name (ASCII format) | 30 FQDEV 


| #0, real dev. no. | device unit number | 32 FQDEVN 


FIRQB+FQDEV The physical device name, as two ASCII characters. 


FIRQB+FQDEVN 


value of 0 (and at offset FIRQB+FQDEVN) indicates the 


public disk structure (SY¥:). If you only want a 
translation from a logical device name to a physical 


device name, you can pass a value of -1 here. (A -1 is 


guaranteed not to be a valid physical device name. ) 


in this byte, in binary. To indicate an explicit 


device number, set the high byte (at FIRQB+FQDEVN+1) to 
some nonzero value. If the physical device name is of 
the form "XYy:" (that is, no unit number is specified), 


then set the entire word at this offset to zero to 
indicate no explicit unit number. 
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Data Returned 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Henne eee eee eee eee eee tee - rrr eee ee eee eee + 
1 EES EAL LASHER AMAL AMEE SALSA SE 0 
Se Se + 
3 Vdd 2 
Se ee + 
5 | logical device f1aGe -l1=N, -2=Y, O=N.A. | 4 XRLOC 
torre eee ee ee eee eee Sl + 
7 | device description | 6 XRCI 
Se Se + 
11 | reasonable buffer size for device | 10 XRBLK 
Sn Se + 
13 TEA AA SEAL RENEE SE Gl AGERE LS. 12 
Se + 
15  PLISLILLIPLAAPLALAPPAALPAAPALPAIDATATDDAE 14 
Sr Sl + 
XRB+XRLOC If there was no logical device name specified or if the 


logical device name cannot be translated to a physical 
device name, this word is returned as zero. If the 
passed logical device name has a PPN associated with 
it, this word is returned as -2. If not, -1l is 
returned. 


XRB+XRCI Description of the device. The low byte contains the 
device’s handler index. The high byte contains a set 
of status flags. 


DDNFS 

DDRLO_ | 

DDWLO | | 

FLGPOS | | | 

FLGMOD | | | | 

FLGFRC | | | | | 

FLGKB | | | | | | 

ee ee ah dt ae 
15 1413121110 9 8| 7 0 
| i + 
| device-type flags | device handler index | 
Henne ne ee ee eee eee eee ten rere ee ee ee eee eee + 
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High Byte - Device-Type Flags 


The bits in the high byte of the flag word are set to 
indicate the type of device specified: 


FLGRND = 1 The device is random-access. 
= 0 The device is sequential. 
FLGKB = 1 The device is a terminal-type device. 
= 0 The device is not a terminal-type device. 
FLGFRC = 1 The device is byte-oriented. That is, the 


-READ and .WRITE directives handle data in 
byte units. 

= 0 The device is block-oriented. The .READ and 
-WRITE directives handle data in block 
units. 


FLGMOD = 1 The device accepts modifiers in .READ and 
»WRITE directives. 
= 0 The device does not accept modifiers in 
»READ and .WRITE directives. 


FLGPOS = 1 The device keeps track of its horizontal 
position and expands characters such as TAB 
to whatever is appropriate for the device. 
You can determine the current horizontal 
position with the .POSTN directive. 

The device does not keep track of its 
horizontal position. 


1 
ro) 


DDWLO 1 The device is a read-only device. 


The device is not write-locked. 


i Wl 
oS 


DDRLO = 1 The device is a write-only device. 
= 0 The device is not read-locked. 


The device is non-file-structured. 
0 The device is file-structured. 


DDNFS 


non 
Ee 


Low Byte -- Device Handler Index 
Bits 0-7 of the flags word contain a handler index that 


indicates the generic kind of device. The currently 
defined values follow. 
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XRB+XRBLK 


+------- +-------- Sa + 
| Octal | | | 
| Value | Symbol | Meaning | 
+------- +t-------- Herr ee ee ee eee eee + 
| | | | 
| 0 | DSKHND | All disks | 
| 2 | TTYHND | All terminals | 
| 4 | DTAHND | DECtape | 
| 6 | LPTHND | All line printers | 
| 10 | PTRHND | Paper tape reader | 
| 12 | PTPHND | Paper tape punch | 
| 14 | CDRHND | Card reader | 
| 16 | MTAHND | Magnetic tape | 
| 20 | PKBHND | Pseudo keyboards | 
| 22 | RXDHND | Flexible diskettes | 
| 24 | RJEHND | 2780 remote job entry | 
| 26 | NULHND | The null device | 
| 30 | DMCHND | The DMC11/DMR11 DDCMP interface | 
| 36 | Reserved | 
| 40 | KMCHND | KMCll | 
| 42 | IBMHND | IBM interconnect | 
| 46 | DMPHND | DMP11/DMV1l1 device | 
t------- +t-------- Hee ee ee eee + 


If the physical device name is valid (either the one 
returned by the monitor’s translation of logical device 
name or the one passed), this word contains the 
monitor’s "best guess" as a reasonable buffer size for 


this device. 


this Chapter. 


See the 
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-LOGS 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre eee eee ee eee eee terre ree eee ee ee ee eee + 
LASSE ISS AA ASI ATA TA EAA AAA AAI IAAI TS 7 |. 8 
terre ee ee ee ee ee eee torre ee ee ee eee eee + 
3 VALLELLLLLLLLLLLLLLLLLLLLLLL LLL LLL LLL LL LLL LL \ 2 
Se tener ee ee ee ee eee + 
5 EISLER SUGL CHES ALARA RELL 4 
Se es + 
7 | project number 1 programmer number | 6 FQPPN 
prec er ee ee eee eee 5 + 
LL |SSASSISIAAIIAIIIAAAA IIASA AAA AAAS AAAS 171 \ 0 
Sl tener ree ee ee ee eee + 
LS |SSAIAIIISAIIIIAII AAAI AAA AAAS AAAS AAAS AAA 2 
terre ee ee eee eee Heer nee ee eee eee eee eee + 
15 COE LCM TLC| 14 
Se es + 
17 Vdaddadaaaadiiida 16 
Se + 
21 A PLLLILLTILLAPLALLLAPPATLPAPSPAAPTTDI TESS D 20 
te -- eee eee eee eee eee eee toe ee ee ee ee eee eee + 
23 ILI CE TELA ETO ATT 22 
Sr + 
2.5 VL aaaaaaadiiida 24 
Se + 
27 Vad 26 
Se es + 
31 | device name (2 cia characters) | 30 FQDEV 
tee ee ee ee ee ee ee eee eee Se + 
33 | #0, unit no. real | device unit number | 32 FQDEVN 
torre ee ee ee ee eee eee tener ee ee eee ee eee eee + 
35 OO OURO 34 
Se + 
37  LPLLLALLLPPLLLLLA LPIA APP LLITPPLPPALY TDD 36 
terre ee ee eee eee tener eee eee eee eee eee + 
FIRQB+FQPPN If a logical device name was passed and it was 
translated to a device designation with an associated 
PPN, the PPN is returned in this word. Otherwise, this 
word is the same as before the .LOGS call was executed. 
FIRQB+FQDEV The physical device name, either the one returned when 
a successful translation of logical device name is made 
or the one passed, if no logical device name was 
passed. The physical device name is returned as two 
ASCII characters. 
FIRQB+FQDEVN The physical device unit number, either the one 


returned when a successful translation of logical 
device name is made or the one passed, if no logical 
device name was passed. The low byte contains the unit 
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Errors 


NODEVC 


Example 


number, in binary. The high byte (at FIRQB+FQDEVN+1 ) 
is either zero, to indicate no explicit device number, 
or nonzero, to indicate an explicit device number. 


The physical device name (either the one passed or the 
one corresponding to the logical device name) is 
invalid. 


The following code asks the monitor to check the name SYSDEV to see if 
it is a defined system logical device name and, if so, to return the 
physical device name and characteristics to the XRB and FIRQB: 


CALL 
MOV 
MOV 
- LOGS 


CLRXRB 
#° RSYS, XRB+XRLEN ;SET XRB TO TRANSLATE LOGICAL 
#° RDEV, XRB+XRBC ;DEVICE NAME "SYSDEV" 
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~MESAG - Message Send/Receive 


Form 


(Load FIRQB and/or XRB for appropriate subfunction) 


-MESAG 
Function 
The .MESAG directive provides access from a MACRO program to the 
RSTS/E local message send/receive services and, if your system is a 
DECnet/E system, to DECnet/E network message send/receive services. 
This section contains FIRQB and XRB formats and error descriptions for 
local message send/receive. (Unless data passed and returned show 
specific values for the XRB, it should be all zeros.) For detailed 
information about each call, see the RSTS/E Programming Manual. For 


information about network message send/receive, see RSTS/E DECnet/E 
Network Programming in MACRO-1l. 


Declare Receiver Subfunction 
Privileges Required 


SYSIO to declare a receiver with an unrestricted name, network server, 
or local object. EXQTA to suppress RIB or message quota checks. 
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Data Passed 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre eee ee eee ee ee eee tere ee eee ee ee ee ee ee eee + 
1 UZ eedaaaaiiiiiiia 0 
i: in i i in ii asia + 
3 Waa 2 
or terre eee ee ee eee eee eee + 
S ISASIIIII11111/1/////\ = Fanction code = 1 | 4 FQFIL 
tence eee eee ee eee eee eee tener eee ee eee eee ee eee + 
7 | | 6 FQPPN 
+ receiver name in ASCII + 
11 | | 10 
+ (space fill to six bytes) + 
13. | 12 
tere ee ee ee eee eee ee eee ten re eee ee ee ee eee ee eee + 
15 | access | object type | 14 FQEXT 
ter ree ee ee eee eee ee eee terre eee ee eee ee ee eee + 
17 | buffer maximum | 16 FQSIZ 
tener eee ee eee ee ee eee ee Se + 
21 | inbound link max | Benen ic max | 20 FQBUFL 
tee ee ee ee ee ee ee ee eee terre ee ee eee ee ee ee eee + 
23 | packet maximum | 22 FQMODE 
terre eee ee eee eee ee eee terete ee ee ee ee ee ee eee + 
29: || pkts/msg | outbound lank max | 24 FOQFLAG 
terre eee ee ee ee ee ee eee i ee + 
27 Zeus 26 
tener ee ee ee ee eee eee ten eee eee eee eee eee eee + 
31 UZ eddiaiiididiiiia 30 
Herne ee ee ee pe ee ee ee ee ee ee eee + 
33 SSILSSPLSPSITSS PSSST RIB number | 32 FQDEVN 
irs tener ee ee ee ee eee ee eee + 
35 ge EGE | 34 
i oe i ii ii ii iii + 
37 yyy 36 
tence ee ee ee eee ee eee terre eee ere ee ee ee ee eee + 
FIRQB+FQPPN If the caller does not have SYSIO privilege, the fifth 


and sixth characters of the receiver name must be the 
caller’s job number as two ASCII digits. 


F IRQB+FQMODE Specifies the maximum number of packets that can be 
queued at any one time. See the RSTS/E Programming 
Manual for more information. Used only in an EMT 
logging program. 


FIRQB+FQFLAG+1 Specifies the number of packets that make up a complete 


message. See the RSTS/E Programming Manual for more 
information. Used only in an EMT logging program. 


B32 


' Data Returned 


- MESAG 


Except for a possible error code in byte 0 of the FIRQB, the declare 
receiver subfunction of .MESAG does not return any meaningful data. 


Errors 
BADCNT 


BADFUO 


BADNAM 


ERRERR 


FIEXST 


INUSE 


_NOBUFS 


PRVIOL 


The specified packet maximum is out of range. 


The receiver name, object type, and access parameters 
passed are inconsistent. 


This error can occur for one of the following reasons: 


o The receiver name passed contains nonprintable 
characters or leading or embedded spaces 


o A job without SYSIO privilege passed a nonblank 
receiver name whose fifth and sixth characters are 
not its job number 


o The specified local object type is invalid 


The call you attempted requires an optional feature 
(such as EMT logging or DECnet) that is not available 
on your system. 


The receiver name passed is being used by another 
receiver, or the local object type you specified is 
Single instance and is already in use. 


The calling job already exists in the system’s list of 
declared receivers. This error may indicate a logic 
error in the program or that a previous program running 
under the same job number failed to remove itself from 
the receiver list before terminating. In the last 
case, issue a remove receiver call, and then reissue 
the declare receiver. (It is common practice to code a 
remove receiver immediately before the declare receiver 
call.) 


There were no small buffers available to hold the 
arguments passed in the declaration. Since the 
system’s use of small buffers is dynamic, a retry may 
succeed. 

This can occur for one of the following reasons: 


o The specified RIB number is out of range 


o The caller does not have the privilege required for 
a particular option 
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QUOTA You have exceeded the RIB or message quotas. 


Remove Receiver Subfunction 

Privileges Required 

JOBCTL to remove the RIB of another job. 

Data Passed 

Mne- Octal Octal Mne- 

monic Offset Offset monic 
i PGC AOE AEC CCR GE) 0 
3 VALLE 2 


FQOSIZM 5 | (See discussion.) | function code = 0 | 4 FQFIL 


11 WEEE 10 


33 if #0, remove all RIBs i RIB number H 32 FQDEVN 
35 A REEN ESI D LA AANA MAAR AA MAMAS RE EE 34 
37 WZ 36 
FIRQB+FQSIZM The value is two times the job number of the 
receiver(s) you want to remove or zero if the 


receiver(s) belong to your own job. To specify a 
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Data Returned 


-MESAG 


conditional remove, set the sign bit. For example, to 
conditionally remove receivers for your own job, set 
this byte equal to 200. 


When the sign bit is set, the remove operation is 
rejected if there are any messages pending for the 
receiver. 


Except for a possible error code in byte 0 of the FIRQB, the remove 
receiver subfunction of .MESAG does not return any meaningful data. 


Exrors 


BADFUO 


INUSE 


PRVIOL 


The argument at FIRQB+FQSIZM was odd. It must be zero 
to remove the calling program or job number times two 
to remove another job. 


Occurs on a conditional remove if there are messages 
pending for the receiver. 


The caller does not have JOBCTL privilege and has 
attempted to remove the receiver ID block (RIB) of 
another job (that is, FIRQB+FQSIZM is nonzero). 


Send Local Data Message Subfunction 


Privileges Required 


SEND to send to a restricted receiver. 
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Data Passed 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se t--- ee ee ee ee re ee eee + 
1 LEENA EMR SAA HARA E UAE CLC 0 
Se + 
3 VL 2 
Si + 
FQSIZM 5 | destination i function code = -1 | 4 FQFIL 
St tenner re ee ee ee ee eee + 
a | 6 FQPPN 
+ receiver name in ASCII + 
11 | | 10 
+ (space fill to six bytes) + 
13 | | 12 
Herr ree eee eee Se + 
15 | | 14 FQEXT 
+ + 
17 | optional user parameter string -- | 16 
+ up to 20 bytes of additional + 
21 | user data can be specified here | 20 
+ + 
23.) (zero fill to 20 bytes) | 22 
+ + 
25 | | 24 
+ + 
27 || | 26 
+ + 
31°) | 30 
+ + 
3.3: | | 32 
+ + 
35 | | 34 
+ + 
37 | | 36 
terre ce ee ee ee ee ee eee Se + 
FIRQB+FQSIZM You can specify the destination in one of three ways: 


Oo 


A zero value indicates that the destination is the 
receiver name that starts at FIRQB+FQPPN. 


A value equal to the job number times two indicates 
that the destination is this job number. If you do 
not specify a name (FIRQB+FQPPN = 0), the system 
locates the receiver by job number; this works only 
when the the receiving job is receiving messages on 
RIB: 0. 
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If you specify a name, the system sends to the 
specified receiver name. However, the system also 
checks that the receiver’s job number matches the 
value in FIRQB+FQSIZM. 


o A value equal to the local object type (LOT) plus 
200 indicates that the destination is the receiver 
for the specified local object type number. Only 
Single-instance object types are valid (see the 
RSTS/E Programming Manual). Legal values are: 


terres 5 + 
| Lot | Receiver | 
tore ten ee rr ee ee ee eee eee + 
| | | 
| 1 | Error logger | 
| 2 | EMT logger | 
| 3 | PBS -- command interpreter | 
| 4 | PBS -- server interpreter | 
| 5 | PBS -- user request packet | 
| 6 | OPSER | 
toner tere ee ee ee ee ee ee ee ee eee + 
FIRQB+FQPPN Specifies the receiver name. If FIRQB+FQSIZM is zero, 


this field must be nonzero. 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tere eee ee ee ee ee ee ee eee tere ee ee ee ee ee eee eee + 
1 | length of output buffer, in bytes, 0-512 | 0O XRLEN 
tere ee ee ee ee ee ee eee ten ener ee ee ee ee eee eee + 
3 |number of bytes to send, 0 to buffer length| 2 XRBC 
tee eee ee eee ee eee eee eee tenner re ee ee ee ee eee + 
a: "|i starting address of buffer | 4 XRLOC 
te - eee ee eee ee eee Sr + 
LI NALIILTAT ISIS ISAS TAL AA AEA ALA AI AALS PATS SSS ITS |. OS 
tee ee ee ee eee eee ee eee terre ee ee ee ee ee eee eee + 
DD ALAS LA AAA LIA ITAA DI AAA AAA AAA TT IIL ALTA A LST | AO 
teen re ee ee ee ee ee eee Here eee eee eee eee + 
LB SLES TLIPSIALAASASTIIAIL IAS SAILS TATTLE OPE |. 22 
terre eee ee eee ee eee tee ee ee ee ee ee ee eee eee + 
MO NSS LS STS APIS AAT AAA AAAS ETP IAAATI AAI AAT T TS TST | 38 
+-- eee ee eee ee eee eee eee terre ee ee ee ee ee eee + 
XRB+XRLEN Length of the output buffer, in bytes. This value can 


range from zero through 512. 
XRB+XRBC The number of bytes to be sent. This value can range 


from zero through the size of the buffer, as specified 
at XRB+XRLEN. 
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XRB+XRLOC Starting address of the output buffer. (See the 
section "XRB (Transfer Request Block)" in Chapter 2 for 
more information. ) 

Data Returned 

Mne- Octal Octal Mne- 

monic Offset Offset monic 

1 AACS RU LALOR MAE 6 GRICE EL MAEM AD ALR MAACE. 0 
3 Vaasa 2 


FQSIZM 5 |job no.*2 of rec. JORI///ILILIII ITIL ILTL 4 
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Errors 


BADCNT 


BADFUO 


NOBUFS 


NOROOM 


NOSUCH 


PRVIOL 


»MESAG 


The XRB+XRLEN value is illegal. It can range from 0 
through 512. 


The value at FIRQB+FQSIZM is odd. It must be zero or 
the receiver’s job number times two. 


System buffers are currently not available to store 
this message for the intended local receiver. A later 
retry may proceed without error. 


The number of pending messages for the intended local 

receiver is at its declared maximum, or the receiving 

program is hibernating. This program should try again 
later. If this error occurs repeatedly, the receiver 

is not processing messages often enough. 


The intended local receiver could not be located in the 
system’s list of declared receivers. The receiver must 
be declared (with a declare receiver) before any data 
can be transmitted to it. 


Some access violation has occurred. Either the 
receiver does not allow any local senders, or the 
sender does not have SEND privilege and the receiver 
allows only restricted senders. 
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Receive Subfunction 
Privileges Required 
None 
Data Passed 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Le VLILISOIPAI LAA AAAS LIS SAT AAES AA AAAS ATI SAFES 8 
in AAA 
FQSIZM 5 | receive modifier | function code = 2 | 4 FQFIL 
7 | qualifier (norm = Q)| sender select | 6 FQPPN 
11 OOO Oe 10 
13 Ueda 12 
15 Vad 14 
17 LPILIILILTILILIILILTLP ELIDA ULI DALLADTED LE 16 
ZL SASSAISSSISSS SSIS AS ASA AA SSAA IIA A SASS S AS17120 
23: | sleep time, in seconds | 22 FQMODE 
25 FAA CEREAL NMEA GA AR Wd ege 24 
27 PLPILLILILLIPIEL ALL TDLIL ILA LD TLD IDTPL ALTA DE 26 
SL |LSSSSISLAS AIST AAITS ASSESS I DATA ASAI ATS SAAT 77 | 30 
33 |SAISSIISSS1A1S11160'07 | RIB number | 32 FQDEVN 
35 (AAEM ELENA SAL USER ALAA SE EIASAD SOMES 34 
37 I LPILLLL LILI ITED ILL LTILILILA IDA TDADA ELT DE 36 
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XRB 
Octal Mne- 
Offset monic 

eee eee eee eee eee oe | 
buffer size in bytes, or 0 | O XRLEN 

ae tee ee ee ee ee ee ee eee eet 
must be 0 | 2 XRBC 

eee ee eee eee eee te -- eee ee ee ee ee eee ee et 
starting address of buffer | 4 XRLOC 

ct eee eee ee eee Sr 7 


TO NLLLSAALII TEAL AA AAA AT AAA TAIT TAA IAAL IST TFS 
11 EL CC 10 
13 LPILIILELILI ADIL ILT LILLIA LILIA ID EDEL TDD 12 
LS LSASASSIIASTAISISIIASA SSIS AAAI AAAS SASS S S111 \ AA 


XRB+XRLEN 


XRB+XRBC 


XRB+XRLOC 


Data Returned 


The size of the receive buffer, in bytes. This word 
can be zero if no user data is desired on the receive. 
The amount of data transferred from a pending message 
will never be greater than the buffer size. 


This word must be passed as zero. The monitor returns 
the actual number of bytes of user data transferred in 
this word location, as shown in the Data Returned 
sections. 


The starting address of the receive buffer. (See the 
section "XRB (Transfer Request Block)" in Chapter 2 for 
more information. ) 


The Receive call returns data to the FIRQB and XRB, identifying the 
type of message received and user data, if any, to the buffer defined 
in the data passed. 


The FIRQB and XRB formats for the local data message follow. 
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Data Returned (Local Data Message) 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
toe - ee ee ee ee ee eee ee eee tere ee ee ee ee ee ee ee eee + 
1 EMA EAA AAL AA RMA AU he 0 
i as + 
3 VLMa 2 
a ie + 
FQSIZM 5 | job number * 2 1 function code = -l1 | 4 FQFIL 
tree er ee ee ee ee eee eee +---- eee ee ee ee ee eee eee + 
7 | project number | programmer number | 6 FQPPN 
t-- eee er ee ee ee eee ee eee terre eee ee ee ee eee + 
Ll (ffl Ill 414A AAA AAA //\ sender KB no. or 377 | 10 FQNAMI1 
tere eee ee ee eee eee eee tere eee re ee ee ee eee eee + 
13 |remainder (number of bytes not transferred)| 12 
tee ee ee ee ee ee eee ee eee te -- eee ee ee ee ee eee eee + 
15 | | 14 FQEXT 
+ + 
Li | Data passed as parameters by the | 16 
+ sender of this message. + 
21 | | 20 
+ + 
23 | | 22 
+ + 
25. || | 24 
+ + 
27° || | 26 
+ + 
31 | | 30 
+ + 
53.5 | 32 
+ + 
35° | 34 
+ + 
37 | | 36 
terre ee ee ee ee ee eee eee tee ee ee ee ee ee eee + 


FIRQB+FQNAM] A value of 377 means the sender is detached. 


FIRQB+FQEXT For an EMT logger message, the monitor returns three 
values: 


o Bytes 14-15 contain the number of data packets not 
transferred. 


o Bytes 16-17 contain the number of EMTs your program 
missed, either because it is not processing data 
packets quickly enough, or because not enough XBUF 
is available to store all the data packets that the 
monitor is creating. 
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monic Offset 


Errors 


BADCNT 


BADFUO 


NOSUCH 


i 


3 


2 


7 


Ll 


13 


LS 
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o Bytes 20-21 contain the number of data packets 
transferred. 


See the RSTS/E Programming Manual for more information. 


XRB 
Octal Mne- 
Offset monic 
er ee 2 
LLLLLILELLLLAAAA LALLA ALAA LALA 0 
ee aS 
|length (actual number of bytes transferred)| 2 XRBC 
ee ee So 
OEE CREO LCE LCL 4 
ee ee | + 
Vad 6 
-_—s ee ee eee ew ee wee ew ewe ew ew ew we ew ew Bw ew wee wee we ewe wee eee mee + 
SP PPLISLAPLILPLLLLPPLEPLALA ALI ADSATPD ADL AL 10 
we ee eee eee Sn 2 
WALA hhh hh 
we eee eee ee ee eee | 
LUE SEN GLIAL Sb AiisEARU AAEMAL 14 
-— = es = es we we ew ew sw ew we ewe wee he Be wee eee ew Bw ew we ew ee el el le el lle + 


The buffer descriptor in the first three words of the 
XRB is invalid. 


Not a declared receiver. Before any receive can 
succeed, you must execute a declare receiver call to 
define the RIB number you want to uSe. 


For a receive without sleep (bit 0 in receive modifier 
= 0), this error indicates that no appropriate messages 
are pending. For a receive with sleep (bit 0 in 
receive modifier = 1), this error is returned when the 
program is awakened from the sleep. The program must 
execute another receive call to retrieve any pending 
messages. 


Send Privileges Subfunction 


This subfunction provides a method for a program to tell another 
program about a job’s current privileges and guarantees that the data 
cannot be falsified. Data can be sent at the same time. 


Privileges Required 


SEND to send to a restricted receiver. 
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Data Passed - Send Privileges 


Mne- Octal Octal Mne- 
monic Offset Offset monic 


a 
3 


FQSIZM 5 


37 


EOC 0 
VILL LLY 2 
destination H function code = -1ll | 4 FQFIL 


+ 

| 

+ 

| | 6 FQPPN 
+ receiver name in ASCII + 

| | 10 
+ (space fill to six bytes) + 

| [a2 

+ 
WALA hee ae 2828 
ASS SSSI AAASAASAIAAA AAAS AAAS AAA AAA AAA 

(WALA SLALIAL SIPS SIATIA TILAPIA A LATS A LSTA IIL 7 28 
AS/SSSASAASAIAAAAAAII AAA AAA AAA AAA AAA AAAS 
WAAL hhh hhh hhh hhh hhh 3 
ASSIS SISA AAS AAA AAA AAA AAA AAA AAA 

WAALAAA AA hhh hhh hhh 


+ optional user parameter string 


24 


26 
+ (up to 12 bytes of additional 
user data can be specified here, 
+ zero fill to 12 bytes) 


30 


32 


34 


36 


+—+—+—+4+—4+—+-—+4 


+—+—+ 


FIRQB+FQSIZM You can specify the destination in one of three ways: 


o A zero value indicates that the destination is the 
receiver name that starts at FIRQB+FQPPN. 


o A value equal to the job number times two indicates 
that the destination is this job number. If you do 
not specify a name (FIRQB+FQPPN = 0), the system 
locates the receiver by job number; this works only 
when the the receiving job is receiving messages on 
RIB QO. 
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FIRQB+FQPPN 


Mne- Octal 
monic Offset 


1 


3 


5 


1S 


XRB+XRLEN 


XRB+XRBC 
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If you specify a name, the system sends to the 
specified receiver name. However, the system also 
checks that the receiver’s job number matches the 
value in FIRQOB+FQSIZM. 


o A value equal to the local object type (LOT) plus 
200 indicates that the destination is the receiver 
for the specified local object type number. Only 
Single-instance object types are valid (see the 
RSTS/E Programming Manual). Legal values are: 


+----- 5 + 
| Lot | Receiver | 
+----- tere re re ee ee ee ee ee ee ee ee eee + 
| | | 
| 1 | Error logger | 
| 2 | EMT logger | 
| 3 | PBS -- command interpreter | 
| 4 | PBS -- server interpreter | 
| 5 | PBS -- user request packet | 
| 6 | OPSER | 
+----- tee eee ee ee ee ee te ee eee ee eee + 


Specifies the receiver name. If FIRQB+FQSIZM is zero, 
this field must be nonzero. 


XRB 
Octal Mne- 
Offset monic 
wet eee ee ee ee ee ee ee eee Se | 
length of output buffer, in bytes, 0-512 | O XRLEN 
we eee eee ee ee eee Se | 
|number of bytes to send, 0 to buffer length| 2 XRBC 
wre ee ee eee eee t--- ee ee eee ee eee ee et 
starting ee of buffer | 4 XRLOC 
ee + 
Veda 6 
== y= = we we ew eee ww wee ewe we we ew ew we wee we eB ww ww BB we we wee el + 
“dddaaaaaaadduiuadaiidia 10 
a a 2 + 
Vdd 12 
Oe a + 
“daaadaaialilia 14 
ee a + 


Length of the output buffer, in bytes. This value can 
range from zero through 512. 


The number of bytes to be sent. This value can range 

from one through the size of the buffer, as specified 

at XRB+XRLEN. If the value in XRB+XRLEN is zero, this 
value must be zero. 
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-MESAG 


- NAME 


eNAME - Set Program Name 
Form 

» NAME 
Function 


The .NAME directive sets the program name in the monitor tables. The 
monitor enters the name in an internal table; otherwise, it makes no 
use of the program name. However, the SHOW USERS command uses the 
names in listing current information for jobs (under the "What" 
column) on the system. The BASIC-PLUS run-time system uses this 
directive when the user issues an OLD, NEW, or RENAME command. 


The program name is passed as two words of RAD50 data in the FIRQB. 
Note that the data is passed in the same location in the FIRQB where 
the file name exists at the P.RUN entry point into a run-time system. 
If you are coding or modifying a run-time system, one of the first 
things to do on entry at P.RUN is to set the program’s name. Thus, 
the file name’s position in the FIRQB at this point is convenient for 
use. 


Privileges Required 


None 


Data Passed 


Mne- Octal 
monic Offset 


1 


3 


terre ee eee eee eee Herr ree ee eee eee eee + 


OE a 


| program name in RAD50 format | 
+ (2 words) + 


FIRQB+FQNAM1 The program name to be set; two words in 


Data Returned 


The .NAME directive does not return any meaningful data. 
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- NAME 


Octal Mne- 
Offset monic 


10 FQNAM1 
12 
14 
16 
20 
22 
24 
26 
30 
32 
34 


36 


RAD50 format. 


- NAME 


Errors 
No errors are possible with the .NAME directive. 
Example 


The following code sets the name PROGRM in the monitor tables: 


MOV #° RPRO, FIRQB+FQNAM1 > Set FIRQB to declare 
MOV #° RGRM, FIRQB+FQNAM1+2 : Name of "PROGRM" 
. NAME 


3-150 


- PEEK 


.- «PEEK - Look at Monitor Memory 
Form 

. PEEK 
Function 


The .PEEK directive returns the contents of one word of the monitor’s 
memory; that is, the memory mapped by the kernel mode APRs (see 
Chapter 2). Only a job with the required privileges can execute the 
.-PEEK directive. (However, you should not base any of your code on 
the contents of monitor memory because DIGITAL reserves the right to 
change the monitor structure and internal addresses at any time, 
except for the addresses listed in Table 3-3.) 


Privileges Required 


RDMEM to read kernel memory other than the I/0 page and WRTMEM to read 
the I/O page. 


Data Passed 
XRB . 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 | virtual address of desired monitor word | 0 XRLEN 
3 WE Ee 2 
5 Vad 4 
7 Vdd 6 
11 A PLLLIPPLLSLSLSILLYLPLESPPTLAALPATLTTLAALAL 10 
13 eae EE EEE ELLE MERA GEESE ELIS EAC GM 12 
15 Uaaddddddddddda 14 
XRB+XRLEN The virtual address of the data word in monitor memory 
whose contents are to be returned. The value must be 
even, since word addresses on the PDP-1l are always 
even. Peeking at data in the I/O page (kernel APR 7, 
or lll (binary) in bits 15, 14, and 13) can cause 
unpredictable system results; DIGITAL does not 
recommend this. Furthermore, using .PEEK to obtain 


data in APRs 5 or 6 returns data in the file 
processor’s private buffer pool. 
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- PEEK 


Use .PEEK to examine addresses returned by get monitor tables calls or 
addresses of fixed monitor locations. 


Table 3-3 shows fixed monitor locations and their addresses. 


Table 3-3: Fixed Monitor Locations 


| Address 
| (Octal) 


44(word) 


46(word) 


1000(word) 
1002(word) 


1006(byte) 


1010(word) 


1012(word) 


1014(word) 


ITIME 


DATE 


TIME 


JOB 


JOBDA 


JOBF 


IOSTS 


The date when the system was last started by 
START. 


The time of day when the system was last 
started by START. 


Current system date. 
Current time of day. 


Job number times 2 of the job currently 
running (always the user’s own job number.) 


Address of the job data block (JDB) of the 
currently running job (always the user’s own 
JDB). 


Address of the JDFLG word in the JDB of the 
currently running job (always the user’s own 
JDB). 


Address of the JDIOST (low) byte and JDPOST 
(high) byte in the JDB of the currently 
running job (always the user’s own JDB). 
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- PEEK 


' Data Returned 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se tore ee eee ee ee ee ee eee + 
2 i] contents of the meni memory word | O XRLEN 
Se i + 
3 VLaaddadadaddiddda 2 
i + 
5 Veda 4 
i + 
7 Vdd 6 
i es + 
11 UV dadadaaddddiddddida 10 
| i eS + 
13 YP PPLSLILLIPLIILLALPAPSL ASA APLAALALPTDL PDE 12 
Sl 5 + 
15 DCCL CAG GCE EC LEE 14 
Si + 
XRB+XRLEN The contents of the requested monitor memory location. 
Errors 
B.4 The address specified caused a trap to the kernel mode 
vector at 4 (UNIBUS timeout, odd address, and so 
forth). 
B.250 The address specified caused a memory management unit 
violation (trap to the kernel mode vector at 250). 
PRVIOL The caller does not have the required privilege. 
Example 


The following code obtains the contents of monitor memory location 
1006 (the low byte of which is the current job number times two): 


MOV #JOB,XRB+XRLEN ; Set address to that of "JOB" 
- PEEK 
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- PLAS 


»-PLAS - Access Resident Library 


The .PLAS (Program Logical Address Space) directive has six 
subfunctions that allow a MACRO program to access a resident library. 
Resident libraries must be so defined by the system manager with the 
INSTALL LIBRARY command (see the RSTS/E System Manager’s Guide). As 
noted in Chapter 2, the easiest way to do this is to link the resident 
library to your program using TKB, the Task Builder that links modules 
assembled or compiled under the RSX run-time system or its 
derivatives. However, you can use .PLAS subfunctions to directly 
access resident libraries. 


Table 3-4 lists the .PLAS subfunctions by function code. The 
following subsections describe the subfunctions in alphabetical order. 
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Table 3-4: 


10 


12 


Summary of 


DTRFQ 


CRAFQ 


ELAFQ 


MAPFQ 


- PLAS 


-PLAS Subfunctions 


Attach resident library. Attaches the job to 
a resident library; necessary before the job 
can map a window to the library. 


Detach resident library. Detach the job from 
a resident library. 


Create address window. Defines a range of 
virtual addresses to be a window for looking 
at all or some portion of a resident library. 
Optionally, CRAFQ maps the window to all or 
some portion of a resident library. (The 
mapping can be done separately with MAPFQ.) 
The CRAFQ subfunction reserves one or more 
APRs, so CRAFQ takes space in the job area 
even though the window may not actually be 
mapped. 


Eliminate address window. Releases the APRs 
used by a particular window. 


Map window. Map an already created address 
window of virtual addresses to actual memory 
locations in an attached resident library. 
The monitor loads the library from disk if 
necessary. 


Unmap address window. Releases a window of 
virtual addresses from a mapping to actual 
memory locations. 


When a program exits or a user logs out, the monitor automatically 
detaches all libraries and unmaps and eliminates all windows for the 
job. , 


Privileges Required 


Depends on the subfunction; 


follow this introductory information on the .PLAS directive. 


3-155 


refer to the individual descriptions that 


- PLAS 
ATRFQ 


ATRFQ (Attach Resident Library) 
Form 


MOVB’ #ATRFQ,FIRQB+FQFIL 


(set appropriate parameters) 


- PLAS 
Function 


The ATRFQ subfunction of .PLAS declares your intent to access a 
resident library. The type of access is specified in the call. The 
number of resident libraries that can be attached to a job at any 
given time is unlimited (subject to the availability of system small 
buffers). 


The job’s ability to access the resident library depends upon the 
protection assigned to the library by the system manager when the 
library was installed. The default protection grants read access to 
all users and denies write access to all users. 


If the calling job can access the library in the specified fashion, 
the monitor sets up its own internal tables, which lay the groundwork 
for the job to map windows to the library. Note, however, that the 
resident library does not take up space in the job area (virtual 
memory) with an attach. APRs are assigned (virtual memory in the job 
area is taken) when a window is created (using CRAFQ). 


Privileges Required 
Read-only or read/write access to the library. The protection code is 
interpreted exactly like a file protection code; as with files, access 


is granted either on the basis of the protection code or because of 
GREAD, GWRITE, WREAD, or WWRITE privileges. 
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Mne- Octal 
monic Offset 


1 
3 
5 


' Data Passed 


Ueda 
WLLL 


LLILLSEL ILLITE LILILIL LILI ILS EE 


teeter ee eee ee eee Sr + 


ANAL ESA EES SACLE RS AEG 


| resident library name in RAD50 format | 
+ (2 words) + 


ALAA hhh 


prec eee eee eee ee eee eee per ree eee eee ee eee eee + 


SREP SEL CK EELS SAAN ALAC EGER SAMA 


I LPILILI LT UL UL ILIAD LL ULI ILILT VAD UD ELD 


Herre eee ee ee ee eee perce eee ee ee eee ee eee + 


Octal 
Offset monic 


0 


2 


- PLAS 
ATRFQ 


Mne- 


4 FQFIL 


6 


10 


FIRQB+FQFIL The function code ATRFQ (octal value = 0). 


FIRQB+12 


FQMODE 


The name of the resident library to which the job is to 


be attached; two words in RAD50 format. 


Resident libraries are made known to the monitor by the 
system manager with the INSTALL/LIBRARY command (see 
the RSTS/E System Manager’s Guide). With this command, 
the system manager defines a file (filename.LIB) as a 
resident library. The monitor regards "filename" as 


the resident library’s name. 
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- PLAS 
ATRFQ 


FIRQB+FQMODE The low-order two bits of this word define the way the 
job wants to access the library: 
Bit 0 =1 Read-only access is desired. 
Bit l1=1 Read/write access is desired. 
Data Returned 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se terre eee eee eee + 
1 EOIN I OO CELLET 0 
3 Vea current job no. * 2 | 2 FQJOB 
5 Veda 4 
7 | resident iibesey identification i 6 FQPPN 


11 | size, in 32-word Dee of the library | 10 FQNAM1 


13 VW aaddddaddddddda 12 


17 I PLLILILILILIL ILL ADIL ID IVIL LILILILILILTLI 16 


Here eee ee eee Here eee eee eee eee + 


21 IEEE SERIE LA AMEE CEES AHA 20 


37 PLT ITIL ITIL ILILI LILI LILILILILTLTLT DID ID 36 


pert tee eee eee eee eee terete eee eee ee ee eee + 
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FIRQB+FQJOB 


FIRQB+FQOPPN 


FIRQB+FQNAM] 
Errors 


NOSUCH 


PRVIOL 


Example 


- PLAS 
ATRFQ 


The current job number times two. 


This word is an identifier that must be used, rather 
than the resident library name, in subsequent calls to 
identify a resident library. Thus, you use this 
identifier to detach the job from the library (DTRFQ) 
and map and unmap windows to the library (MAPFQ and 
UMPFQ). 


The size of the resident library, in 32-word blocks. 


The resident library specified in the data passed is 
not known to the monitor. The system manager must 
install a resident library before it can be used. 


The attach did not succeed because the caller’s 
privilege did not allow the access specified in the 
data passed. This could happen either: 


o Because the access code specified in the data 
passed is not compatible with the possible access 
defined when the library was installed by the 
system manager. 


o Because the protection code associated with the 
resident library file excludes access by the user. 


The following code attaches the job to a resident library called 
DATBAS. The access desired is defined as read/write: 


MOVB #ATRFQ, FIRQB+FQFIL ;DEFINE FUNCTION CODE 
MOV #° RDAT, FIRQB+12 ; LIBRARY NAME IS 

MOV #° RBAS , FIRQB+FQEXT ;DEFINED AS "DATBAS" 
MOV #2,F IRQB+FQMODE ; ACCESS=READWRITE 

- PLAS 


3-159 


- PLAS 
CRAFQ 


CRAFQ (Create Address Window) 
Form 


MOVB #CRAFQ, FIRQB+FQOFIL 


(set up parameters) 


e 


- PLAS 
Function 


The CRAFQ subfunction of .PLAS can be used either to create a window 
(a range of virtual addresses) or to create a window of virtual 
addresses and map it to a range of actual addresses in an attached 
library. You define the range of addresses by: 


o Naming a base APR (which defines the starting address of the 
window) 


o Specifying the size of the window in 32-word blocks 


Thus, a window always begins on a 4K-word boundary in virtual memory 
and always takes at least 4K words. It may take more than 4K words, 
depending on the size of the window. 


If the address range overlaps the user job image, the call fails with 
an error. The address range cannot overlap the run-time system (high 
segment). However, if the job is currently running under RSX 
emulation, this is not a consideration. APR 7, normally used to map a 
run-time system, can be used instead to map a window to a resident 
library. If the address range overlaps an existing window, the 
previously created window is eliminated. 


The difference between creating a window and creating and mapping a 
window is best shown by example. By using create without map, you can 
define one window, which can be mapped to a library or portion of a 
library and then remapped to another portion of the same library or 
another library, as many times as desired, using the MAPFQ subfunction 
of .PLAS. 


For example, suppose your program takes up 24K words and you want to 
access a 24K-word resident library of data values. You can use create 
without map to set up a 4K-word window in APR 6. You can then map the 
window (using MAPFQ) to the first 4K words of the library, process the 
data, map to the next 4K words of the library, and so forth. 
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«PLAS 
CRAFQ 


If, on the other hand, you had a 4K program and still wanted to access 
a 24K-word library, you could use CRAFQ to create a 24K-word window 
and map it to the entire library in APR 1 to 6. 


A job can create a maximum of seven windows. A window takes at least 
one APR (it may take more, depending on the size you specify for the 
window). Thus, the maximum of seven assumes seven windows in APR 1 to 
7. APR O can never be used to create a window, since the user program 
takes at least this much space. As mentioned previously, a window 
cannot overlap the user job image; thus, the size of the user job 
image determines the lowest base APR that can be used. If the program 
(user job image) is less than 4K words, APR 1 and up (to the limit 
imposed by the run-time system boundary) can be used to create 
windows. If the user job image is between 4K words and 8K words, APR 
2 and up can be used to create windows, and so forth. 


If a window is created that overlaps an already existing window, the 
old window is eliminated. For example, if you create a 6K-word window 
using a base APR of 5, the window uses APR 5 and APR 6. If you then 
create a 4K-word window using a base APR of 6, the entire old window 
is eliminated. APR 5 is then free for other use; APR 6 is used for 
the new window. 


Privileges Required 


RDMEM to map physical memory other than I/O page read-only. SYSMOD to 
map physical memory read/write or to map the I/O page read/only. 
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- PLAS 
CRAFQ 


Data Passed 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Hanne ee eee eee tenner ee ee ee ee eee eter + 
1 TALES EAA AGERE CARU ME Slis Mele HAL OL GAM 0 
i ee ae + 
3 Vea 2 
Se ie + 
) I PLILILILTILILPILILT CRAFQ (= 4) | 4 FQFIL 
Se Sr + 
7 | base APR (1-7) WAAL 
5 Sr + 
11 EAE AAA AAA L SAS AE ACER GHEE A AEALEE LEAL 10 
Se aie + 
13 | size of Pe in 32-word blocks | 12 
Se a + 
15: | library identification (for map only) | 14 FQEXT 
Se Se + 
17 | offset, in 32-word aaa (for map only) | 16 FQSIZ 
Se ae + 
21 | length, in 32-word Bieeke (for map only) | 20 FQBUFL 
Se Sr + 
23° || access flags | 22 FQMODE 
Si terre ee ee ee ee eee eee + 
25 Cee 24 
Sn oe + 
27 Vad 26 
i + 
31 VZeaadadiddaidiidda 30 
ee + 
33 LPILILL IPAS ALL ELALLILAALTPLIDADADPAD DLE 32 
tenn eee eee eee ee eee Hee ree eee ee eee eee + 
BS ISSASAIIISIIIIAS AAAS AAA AAAS AAAS AA AAAS AA \ 34 
i re + 
37 MERE A ENA L A KAA E RECA AMA SAAS ARIEL. 36 
Sn iii + 

FIROB+FQFIL The function code CRAFQ (octal value = 4). 

FIRQB+7 The base APR of the window, 1 to 7. Implicitly defines 
the starting virtual address of the window. This byte 
cannot be zero; in addition, it cannot name an APR 
already being used to map the user job image. 

FIRQB+12 The desired size of the window, in 32-word blocks. 


example, a value of 128. equals 4K words. 
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FIROB+FQEXT 


FIRQB+FQSIZ 


FIRQOB+FQBUFL 


FIT RQB+FOQMODE 


-PLAS 
CRAFQ 


The identifier of the resident library to which the 
window is to be mapped. (This is the value returned by 
the ATRFQ function of .PLAS at FIRQB+FQPPN.) This word 
is ignored for calls requesting a create without 
mapping (bit 7 at FIRQB+FQMODE equals 0). 


You can also map the window to physical memory by 
passing a value of -4. See MAPFQ for details. 


The offset, in 32-word blocks, from the start of the 
library where the mapping is to begin. This word is 
ignored if no mapping is requested (bit 7 at 
FIRQB+FQMODE equals 0). A value of zero for this word 
indicates the window is to be mapped beginning at the 
first byte of the library. A value of one indicates 
the window is to be mapped beginning at the 33rd word 
of the library (starting address + 64), and so forth. 


The length, in 32-word blocks, of the area to be mapped 
(ignored if bit 7 at FIRQB+FQMODE equals 0). This 
value cannot be greater than the size of the window 
specified at FIRQB+12. Furthermore, this value, 
combined with the offset value at FIRQB+FQSIZ, cannot 
indicate an address beyond the end of the library or 
into the high segment (run-time system). 


A value of zero for this word defaults to either the 
size of the window (specified at FIRQB+FQEXT) or the 
Space remaining in the library, whichever is smaller. 


Two bits in this word define whether the window is to 
be mapped and whether write access to the window is 
desired: 


bit 1 =1 Write access to the window is desired. 
= 0 No write access to the window is desired. 
bit 7 1 The window is to be mapped. 


0 The window is not to be mapped. 


The octal value to set bit 7 is 200; the value to set 
bit 1 is 2. Thus, an octal value of 202 for this word 
requests mapping and write access. A separate setting 
for write access in CRAFQ and in ATRFQ allows you to 
attach to a library read/write and map a portion of the 
library read-only. 
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- PLAS 
CRAFQ 


Data Returned 


Mne- Octal 
monic Offset 


1 


3 


Octal 


LPILILILILI AIL ULI ILT IDLY LL ALIL TDD ILL TLD 
ASILIIIIS 111111 ///7//\ carcrent job no. * 2 | 


LPILILIITILILTLT ILL window ID | 


FIRQB+FQJOB The current job number times two. 


0 
2 


Mne- 


Offset monic 


FQJOB 


FQPPN 


FQNAM1 


FQBUFL 


FQMODE 


FIRQB+FQPPN The window ID. Use in later MAPFQ calls to map the 
newly created window; it must be used in any ELAFQ 


FIRQB+FQNAM1 


FIRQB+FOBUFL 


calls to eliminate the newly created windows. 


value returned may be from 1 to 7. 


blocks. 
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The 


The starting virtual address of the new window. 


Length actually mapped by the window, in 32-word 


FIRQB+FQMODE 


Errors 


BADFUO 


NOBUFS 


NOROOM 


NOSUCH 


PRVIOL 


» PLAS 
CRAFQ 


Status flags. The monitor returns the status of the 
new window as follows: 


bit 15 = 1 Window was created successfully. 
= 0 Window was not created successfully. 


bit 14 


1 An existing window was unmapped because it 
overlapped the newly created mapping. 
= 0 No existing windows were unmapped by this 


mapping. 
bit 13 


Nl 
~ 


An existing window was eliminated because 
it overlapped the newly created window. 

= 0 No existing windows were eliminated by this 
create. 


Either the base APR and window length specified were 
invalid, or the offset and mapping length values 
specified were invalid. (For example, an offset 
indicating a starting address for the mapping that is 
beyond the end of the library or into the run-time 
system is invalid.) 


Creating a window requires a small buffer; a small 
buffer is not currently available. 


You attempted to create more than seven address 
windows. 


The library ID specified for mapping is not a library 
currently attached to the job. 


The create was unsuccessful because the user privileges 
do not allow the access desired. At this point, since 
the library has been attached successfully with some 
access defined, this error means that the access 
requested in the CRAFQ is not allowed by the access 
requested in the ATRFQ. 
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- PLAS 
CRAFQ 


Example 
The following code creates a 4K-word address window and maps it to the 


beginning of a library whose ID (returned from a previous ATRFQ) has 
been stored at location LIBID: 


MOVB #CRAFQ, FIRQB+FQFIL ;DEFINE FUNCTION CODE 

MOV #6,FIRQB+7 ;BASE APR = 6 

MOV #200,FIRQB+12 ;WINDOW = 4K WORDS 

MOV LIBID, FIRQB+FQEXT ;SET LIBRARY ID 

CLR FIRQB+FQSIZ ;OFFSET = 0 

CLR FIRQB+FQBUFL ;MAP 4K WORDS OR TO 
;END OF LIBRARY 

MOV #200,FIRQB+FQMODE ;MAP WINDOW, READ-ONLY 

» PLAS 
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- PLAS 
DTRFQ 


DTRFQ (Detach Resident Library) 
Form 
MOVB #DTRFQ, FIROB+FQFIL 


(define library to be detached) 


. PLAS 
Function 


The DTRFQ subfunction of .PLAS detaches a previously attached resident 
library. Any windows mapped to the library by the calling job are 
unmapped. If no other jobs are currently attached to the library and 
it was installed with the /UNLOAD option, the monitor removes the 
library from memory. 


If this is a dynamic region and there are no other jobs currently 
attached to it, and the region is marked for deletion after the last 
job detaches, the monitor removes the region from memory and deletes 
it from the resident library list. 

Privileges Required 


None 
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- PLAS 
DTRFQ 


Data Passed 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
ter ccc er ee ee ee ee eee eee te -- ee ee ee ee eee ee ee eee + 


1 Uda 0 

3 Vdd 2 

5 PILILILTILILILILTLT | DTRFQ (= 2) | 4 FQFIL 

7 |library identification (returned by ATRFQ) | 6 FOPPN 
5 foe r ere eens + 


11 Ul eeeeeeeeaedddidddddcddeaddddddidda 10 


FIRQB+FQFIL The function code DTRFQ (octal value = 2). 


FIRQB+FQPPN The library identification returned at FIRQB+FQPPN by 
the ATRFQ that attached the job to the library. 
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Data Returned 


Mne- Octal 


monic Offset 


1 


3 


5 


Octal 


NAA AA AMEE ERE AEA AE Ohh ENE R LAGE: 
PLILILILL USIP IL ILD current job no. * 2 | 


FIRQB+FQJOB The current job number times two. 


FIRQB+FQMODE 


as a result of this detach. 
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0 


2 


Mne- 


FQJOB 


FOQMODE 


- PLAS 
DTRFQ 


Offset monic 


Bit 14 of this word is set if any windows were unmapped 


- PLAS 


DTRFQ 

Errors 

NOSUCH The library ID specified at FIRQB+FQPPN in the data 
passed does not identify any library currently attached 
to the job. 

Example 


The following code detaches the library whose ID is stored at LIBID: 


MOVB #DTRFQ, FIRQB+FQFIL ;SET FUNCTION CODE 
MOV LIBID, FIRQB+FQPPN ;SET LIBRARY ID 
- PLAS 
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- PLAS 
ELAFQ 
ELAFQ (Eliminate Address Window) 
Form 
MOVB #ELAFQ, FIRQB+FQFIL 


(set up parameters in FIRQB) 

- PLAS 
Function 
The ELAFQ subfunction of .PLAS eliminates an address window that was 
created by the job, unmapping the window if necessary. ELAFQ frees 
the APRs used by the window and makes them available for creating 
another window or for expanding the user job image size. 


Privileges Required 


None 
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Data Passed 
Mne- Octal | Octal Mne- 
monic Offset Offset monic 
1 CAEL EA GNA AERA EERE ME A aah 0 
3 Veda 2 
5  PILILLILILILTILTLT A ELAFQ ( = 6) | 4 FQFIL 
TVSSISSSSSSSSASSSS1S 117 \ window ID | 6 FQPPN 
1 WLLL 10 
13 YP LPLLLILILTILPILALLILL ELIDA AL ELT ILIAD ID TTD 12 
15 RAMA AREA SSA EMAL ALOHA A cane 14 
17 aad 16 
21 LILLILILLILILLILTLL ALLL IL LLDILTLD ULL TTD 20 
2B USSSIAIISIISISII SALSA AAAS I ASSIA I AAS ASIA AAA 1 | 22 
25 |SSSSSISISASISIIS SASSI AAI AA SAAS AAAS A ASS 1 \ 24 
27 ALA he EASELS G AGAMA EA EURAREM 26 
31 LLLLIILILA LIPID ILTLL APTA ELITES AUDA LE 30 
B38 ISSSAISIIIIIAIIIISIIIII AISI AS SSAA I AAAS A ASS \ 32 
35 CEG A at) 34 
37 Vdd 36 


FIRQB+FQFIL The function code ELAFQ (octal value equals 6). 


FIRQB+FQPPN The ID of the window to be eliminated (returned at 
FIRQB+FQPPN by the CRAFQ that created the window). 
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Data Returned 


Mne- Octal 
monic Offset 


1 


3 


5 


Hore re ee eee eee ee eee torre ee eee eee ee ee eee + 


AAA hhh hhh 
AIISII IIASA 111 111/77 7/\ carcent job no. * 2 | 


FIRQB+FQJOB The current job number times two. 


FIRQB+FQMODE 


window: 


Bit 13 


Octal 
Offset monic 


0 


2 


4 


6 


- PLAS 
ELAFQ 


Mne- 


FQJOB 


FOQMODE 


Two bits in this word indicate the status of the 


= 1 The window was successfully eliminated. 
= 0 The window was not eliminated. 


Bit 14 = 1 The address window was mapped to a resident 
library and has been unmapped. 
= 0 The address window was not mapped; no 


unmapping was done. 
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- PLAS 
ELAFQ 


- PLAS 
MAPFQ 


Data Passed 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 PL PLILLPLLILSPAAISPPP LALA ALPPPPAALPP PALES | 0 
3 EAE MD tl AAAAG AAA ALE ELLE GAS SIRE AU MER EM 2 


5 PLPILTLLILILI ITIL ILI MAPFQ ( =10) | 4 FQFIL 
TOVSSSSSSSLISSSSSSS SSS S 7 | window ID | 6 FQPPN 


1S: -| eelicae. library ID | 14 FQEXT 
17 | offset, in 32-word blocks | 16 FOQSIZ 
21 | length, in 32-word blocks, to be mapped | 20 FQBUFL 


23 | desired rence mode | 22 FQMODE 


FIRQB+FQFIL The function code MAPFQ (octal value equals 10). 


FIRQB+FQPPN The ID of the window to be mapped (returned at 
FIRQB+FQPPN by the CRAFQ subfunction call that created 
the window). 


FIRQB+FQEXT The ID of the resident library to which the window is 
to be mapped (returned as a full word at FIRQB+FQPPN by 
the ATRFQ subfunction call that attached the job to the 
resident library). 


FIRQB+FQSIZ 


FIRQB+FQBUFL 


FTROB+FQMODE 


- PLAS 
MAPFQ 


The offset from the start of the library where the 
mapping is to begin, in 32-word blocks. A value of 
zero for this word indicates the window is to be mapped 
beginning at the first byte of the library. A value of 
l indicates that the window is to be mapped beginning 
at the 33rd word of the library (starting address = 
64), and so forth. 


The length of the area to be mapped, in 32-word blocks. 
This value cannot be greater than the size of the 
window (specified at FIRQB+12 in the CRAFQ which 
created the window). Furthermore, this value, combined 
with the offset value at FIRQB+FQSIZ, cannot indicate 
an address beyond the end of the library. 


A value of 0 for this word defaults to either the size 
of the window or the space remaining in the library, 
whichever is smaller. 


Bit 1 of this word specifies whether the window is to 
be mapped read/write or read-only: 

Bit l 1 Read/write access. 
0 Read-only access. 


A separate setting for access in MAPFQ and in ATRFQ 
allows you to attach to a library read/write and map a 
portion of the library read-only. You cannot, however, 
attach to a library read-only and then map to the 
library read/write. 
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MAPFQ 


Data Returned 


Mne- Octal 
monic Offset 


1 


3 


terre ere ee eee eee Herre ee ee eee eee + 


ALAA hhh 
ASIII IISTT1 1111 //////\ carrent job no. * 2 | 


| length, in 32-word Blecke: actually mapped| 


FIRQB+FQJOB The current job number times two. 


Octal 
Offset monic 


0 


2 


Mne- 


FQJOB 


FQOBUFL 


FQMODE 


FIRQB+FQBUFL Length actually mapped by the call, in 32-word blocks. 


FIRQB+FQMODE Bit 14 of this word is a status flag: 


Bit 14 


1 The window specified was already mapped; 


the window was unmapped before this mapping 


was done. 


= 0 The window specified had no previous 
mapping; no unmapping was done for this 


call. 
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MAPFQ 
/ Errors 

BADFUO The offset and length specified are inconsistent; 
either the mapping attempted to go beyond the end of 
the library or the length is greater than the created 
window. 

NOSUCH Either the resident library ID or the address window ID 
is incorrect. (The job is not currently attached to 
the specified resident library or no address window has 
been created with the specified window ID.) 

Example 


The following code maps a window whose ID is stored at WINID to the 
attached library whose ID is stored at LIBID. The offset of 256 
indicates that the mapping is to begin 8K words from the start of the 
library. Access to the library is read-only. For example: 


MOVB #MAPFQ, FIRQB+FQFIL ;SET FUNCTION CODE 

MOVB WINID, FIRQOB+FQPPN ;SET WINDOW ID 

MOV LIBID, FIRQB+FQEXT ;SET LIBRARY ID 

MOV #256.,FIRQB+FQSIZ ;OFFSET 8K WORDS 

CLR FIRQB+FQBUFL ;MAP WINDOW SIZE OR 
;TO END OF LIBRARY 

CLR FIRQB+FQMODE ;READ-ONLY ACCESS 

- PLAS 


Map Physical Memory 


You can also use MAPFQ to map a window to physical memory. The data 
passed is the same as for a resident library except FIRQB+FQEXT 
contains -4. The data returned is the same. 


You can map to monitor memory, XBUF, user memory, and so on, but not 
to locked memory (including virtual disk), or non-existent memory. If 
you try to map to locked or non-existent memory, you get a privilege 


violation error. 
Privileges 
You need RDMEM to map read/write or read-only. You need SYSMOD to map 


read/write. If the starting address in memory is 17760000 or higher 
(block number 177600), you also need SYSMOD for read-only. 
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Data Passed (Map Physical Memory) 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre ee ee ee ee eee eee perc tee ee eee ee ee eee + 
1 EEE LAMA LEELA GAIA CAENM OSE GEE WALA Eee 0 
= see ee eee nwneeew eee enenwnvnwnee es we we ews ewe enwe5nsvVw5wnwneseweewene + 
3 Wadd 2 
ee + 
5 WE MAPFQ ( =10) | 4 FQFIL 
i Herre ere eee eee ee eee eee + 
7 ASEM ASE ACA RAMEE EEE window ID | 6 FQPPN 
ee Se a + 
11 WZ 10 
SS + 
13 Vad 12 
Se ee ne + 
15 | 4 | 14 FQEXT 
Se Herr tee ere eee eee + 
17 | starting ata in 32-word blocks | 16 FQSIZ 
Se ie + 
21 | length, in 32-word blceks, to be mapped | 20 FQBUFL 
Se Heer eee ee eee ee eee eee + 
23 | desired aaa mode | 22 FQMODE 
Se oe + 
25 Vad 24 
ee + 


27 WLLL 26 


31 WLLL 30 


+ eeeewewenwreeenee sw we ewveenveeewedk se wee ewes eeee ewe weve e ee © © 
33 Veda 32 
Se + 
35 Uda 34 
Se a + 
37 Vad 36 
ee i a is + 
FIRQB+FQFIL The function code MAPFQ (octal value equals 10). 
FIRQB+FQPPN The ID of the window to be mapped (returned at 
FIRQB+FQPPN by the CRAFQ subfunction call that created 
the window). 
FIRQB+FQEXT -4 to indicate map to physical memory. 
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FIROB+FQSIZ 


FIRQB+FQBUFL 


FIRQB+FQMODE 


Errors 


PRVIOL 


- PLAS 
MAPFQ 


The offset from the start of memory where the mapping 
is to begin, in 32-word blocks. A value of zero for 
this word indicates the window is to be mapped 
beginning at the first byte of physical memory. A 
value of 1 indicates that the window is to be mapped 
beginning at the 33rd word of physical memory (starting 
address = 64), and so forth. 


The length of the area to be mapped, in 32-word blocks. 
This value cannot be greater than the size of the 
window (specified at FIRQB+12 in the CRAFQ which 
created the window). Furthermore, this value, combined 
with the offset value at FIRQB+FQSIZ, cannot indicate 
an address beyond the end of physical memory. 


A value of zero for this word defaults to either the 
size of the window or the space remaining in physical 
memory, whichever is smaller. 


Bit 1 of this word specifies whether the window is to 
be mapped read/write or read-only: 

Bit l 1 Read/write access. 
0 Read-only access. 


You need SYSMOD privilege to map read/write. You need 
RDMEM privilege to map either way. If you want to map 
the I/O page by specifying a starting address of 
17760000 or higher (block number 177600), you need 
SYSMOD privilege to map either way. 


You can map to monitor memory, XBUF, or user memory, 
but not to locked memory (including virtual disk), or 
nonexistent memory. 


The mapping was unsuccessful because user privileges 
did not allow the access desired or you attempted to 
map to locked or nonexistent memory. 
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UMPFQ 


UMPFQ (Unmap Address Window) 


Form 


MOVB #UMPFQ, FIRQB+FQOFIL 


(set up parameters) 


- PLAS 


Function 


The UMPFQ subfunction of .PLAS unmaps a specified address window from 
a resident library. (Note that a MAPFQ on an already mapped window 
unmaps the existing windows. ) 

Privileges Required 


None 
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- PLAS 
UMPFQ 


' Data Passed 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
EU AAA hhh 
VELL 
) Ne EGER EAA EEA UMPFQ (= 12) | 4 FQFIL 
7 VIILILILIDIILILILIDT IN window ID | 6 FQPPN 
U1 WLLL 10 
13 Ueda 12 
15 Vasa 14 
17 Uda 16 
21 UZaaaaddddaaiiaiidda 20 
23 PP PILLLL LILI LTLLILELL EL IPALL ILIAD EDAD IDE 22 
25 IAA SALES AAAS ERE Hi ee aad 24 
27 Vad 26 
31 I PLLLLLILILT LDAP IPEDT IL ELLLL ALITA LDAP IDE 30 
B38 SSSI IIIIISSAAAISI AAAS ISAS AAAS SSAA 11 \ 32 
BS SSSA IIIIAII AAAI IISA AAA AAAS ASSESS 117 \ 34 
37 A 36 


FIRQB+FQFIL The function code UMPFQ (octal value equals 12). 


FIRQB+FQPPN The ID of the window to be unmapped (returned at 
FIRQB+FQPPN by the CRAFQ that created the window). 
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- PLAS 
UMPFQ 


Data Returned 


Mne- Octal 
monic Offset 


1 


3 


ASIII ILIA 1114/////\ carrent job no. * 2 | 
parr rere eee eee eee Herre ee ee eee eee + 


VL edadddasdaiidddda 


LLILILLILI ILI L LILIA AL ALTA ALTA ULLAL 


0 Se + 
| waaay: flag | 


FIRQB+FQJOB The current job number times two. 


FIRQOB+FQMODE 


Errors 


BADFUO 


NOSUCH 


successful. 


Octal 
Offset monic 


0 


2 


Mne- 


FQJOB 


FQMODE 


Bit 13 of this word is set if the unmapping was 


The window ID specified is invalid (not in the range 1 


to 7). 


The window ID specified is in the range 1 to 7, but no 
such window is currently created for the job. 
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- PLAS 
UMPFQ 


. Example 


The following code unmaps the window whose ID is stored at WINID: 


MOVB #UMPFQ, FIRQB+FQFIL ;SET FUNCTION CODE 
MOVB WINID, FIRQB+FQPPN 
- PLAS 
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-POSTN ~- Return Current Horizontal Position 
Form 
- POSTN 
Function 
The .POSTN directive returns the maximum line width and the current 
horizontal position of devices for which this information is relevant 
(line printers and terminals). Data is passed in the XRB defining the 
channel where the device is currently opened. The information is 
returned in the XRB. 
Privileges Required 
None 
Data Passed 
XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
LYSSSAIAISIASIAAAI AAAI AAA AAA AAA AAA ASAE A147 
ZB VSSASSAIISIIIAASISIAIAA IIIA AAAS AAA ASS AA \ 2 
5 AA CME ESM EE APRA AA LLNEL EAL ek le 4 
7 Wn channel number * 2 | 6 XRCI 
LL SSASAAASIAI AISA AIA AAA AAA AA AAA AAA AAAS A117 9 
13 OT eee GO 12 
15 Zea 14 


XRB+XRCI Channel number times two; defines the channel on which 
the file or device is open. 
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Data Returned 


Mne- Octal 
monic Offset 


1 
3 


3) 


15 


XRB+XRLEN 


XRB+XRBC 


Errors 
NOTOPN 
DETKEY 


Example 


- POSTN 


XRB 
Octal Mne- 
Offset monic 
we ee ee ee ee ee ee eee en 
ASAI S ISAS A 4/7 ///\ taximaum line length | 0 XRLEN 
i eon» 
CARLES EACLE current position | 2 XRBC 


LILIA LI LLLILILILILILILILILILILILTLTDIDT 4 
| “ddd | 6 
Wadd 10 
 PLPILILILILT ITIL UL ILILT ADIL ELIDILTID ADIL IDE 12 


OE 14 


The file or device’s maximum line length plus one. For 
example, a value of 81. would indicate a maximum line 
length of 80. bytes. 


The file or device’s current horizontal position is 
returned here. The value can range from zero (leftmost 
character) to the value returned at XRB+XRLEN minus one 
(rightmost character). If the device does not keep 
track of its own horizontal position, then this value 
is zero. The FLGPOS status bit returned in the FIRQB 
when the file or device was opened indicates whether 
the value returned here is meaningful. 


No file or device is open on the specified channel. 


The device is a terminal that is detached. 


The following code requests the current horizontal position of the 
device open on channel 4: 


MOVB 
-POSTN 


#4*2,XRB+XRCI ;SET CHANNEL TO 4 
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»READ - Read Data from File or Device 
Form 

» READ 
Function 


The .READ directive reads data from a file or device previously opened 
on a channel. The amount of data read depends on the device and the 
size of the buffer area, as defined in the XRB. The number of bytes 
transferred is always less than or equal to the buffer size. The 
actual number of bytes read is returned in the XRB when the directive 
is complete. Specific details for each device are given in Table 3-5. 
The "best guess" buffer sizes (returned by the monitor at FIRQB+FQBUFL 
when the device was opened) are also shown, for comparison. 
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- READ 


Table 3-5: Data Input with .READ 


occ cece ccc eee tore cece neces Herc cece cee tere ec en ceee Heer cree wwe eee ee werner nee nec e eens + 
| | | | | What Happens When | 
| | Block | "Best | terse cr ccees Se + 
| | Size, | Guess," | .READ’s” | Buffer | Buffer | 
| | Bytes | Bytes | Intent to | Size | Size | 
| Device | (Decimal) | (Decimal) | Deliver | >Intent | <Intent | 
| Se + 
| Byte-Oriented Devices (FLGFRC=1, FLGRND=0) | 
eee cece ee eens Heer reccecee tere cece eee tere e eee ceee tecr tcc eens Herre eee ew ewe eww rene ense + 
| | | | | | | 
| Keyboard | N/A | 128 } 1 line * { 1 line * | Fill buffer; next .READ | 
| (Terminal) | | | | | reads next part of line. | 
| | | | | | 
| Pseudo | N/A | 128 | Full | N/A | N/A | 
| Keyboard | | | buffer | | | 
| | | | | | | 
| Paper Tape | N/A | 128 | Full | N/A | N/A | 
| Reader | | | buffer | | | 
| | | | | | | 
| Card | N/A | 160 | l card | 1 card | Fill buffer; next .READ | 
| Reader | | | | | reads next part of card. | 
Se + 
| Block-Sequential Devices (FLGFRC=#0, FLGRND=1) | 
torr ccc ec ceeee Hore sce eeee i terse ceccene tec cree ence Her eee eee cece e cere eee eee + 
| | | | | | | 
| Magnetic | 18 to | 512 | 1 block | 1 block | Fill buffer; next .READ | 
| Tape | 32,767 | | | | starts with new block. | 
| | | | | {| (Error returned. ) | 
| | | | | | | 
| DECtape | 510 | 510 | 1 block | 1 block | Fill buffer; next .READ | 
| (file- | | | | | starts with new block. | 
| structured) | | | | | (No error returned.) | 
| | | | | | | 
| DMC/DMR } 1 to 632 | 512 | 1 message | 1 message | Delivers partial message. | 
| | | | | | Next .READ delivers next | 
| | | | | message. 
a i i ee ee ee ee + 
| Block-Random Devices (FLGFRC=0, FLGRND#=0) | 
terre renee eee tere cr ec ecee teens ececee- tere ccc ecene Ss + 
| | | | | 
| Disk | 512 | 512 | Full | Fills buffer; next .READ starts with | 
| | | | buffer | new block. ** | 
| | | | 
| Flexible | Kak | 512 Full ' Pills buffer; next .READ starts with § | 
| Diskette | | | buffer | new block or sector, ** | 
| | | | | | 
| DECtape | 512 | 512 } 1 block {| 1 block j| Fill buffer; next .READ | 
| (non-file- | | | | | starts with new block. | 
) structured) | | | | | (No error returned.) | 
a Se RS aa + 
| | 
| * A line is any number of characters terminated by RETURN, LINE FEED, ESCAPE, FORM | 
| FEED, CTRL/Z, CTRL/D, CTRL/C, or a user-set private delimiter. | 
| | 
| ** If the buffer size is not a multiple of the blocksize, the remainder of the last | 
| block is not read. The next .READ starts with a new block: either the next | 
| sequential block (XRB+XRBLK=0) or the nth block (XRB+XRBLK=n). No error is returned. | 
| | 
| *** 512(block mode) or 128 (RxX01 or RX02 single-density sector mode) or 256 (RX02 | 
| double- density sector mode) | 
oe aa + 


Privileges Required 


None 
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Data Passed 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre ree re ee ee eee eee Herren eee ee eee ee eee + 
1 | size of the buffer in bytes, must # 0 | 0 XRLEN 
Hort tr tee eee eee terre er ree eee eee + 
3.1 (must be 0) | 2 XRBC 
torre ere meets tener er eee eee eee eee + 
5° starting address of buffer | 4 XRLOC 
Si tener ree ree eee + 
XRBLKM 7 | MSB of block number | channel number * 2 | 6 XRCI 
St tere eer tee eee + 
11 | LSB of block number to begin (0 = next) | 10 XRBLK 
St i Se + 
13 | wait time for terminal input | 12 XRTIME 
Here ee ee eee tenn re ee re eee + 
15: | device-dependent modifier | 14 XRMOD 
Hoenn eee eee tee ee ee ee eee eee + 

XRB+XRLEN The length of the input buffer, in bytes. This word 
must be nonzero. The amount of data read depends on 
both the device and the buffer size. However, the 
amount of data is never more than the buffer size. See 
Table 3-5 for details on reads for specific devices. 

XRB+XRBC This word must be passed as zero. The monitor returns 
the actual number of bytes transferred in this word 
location (see the Data Returned section). 

XRB+XRLOC The starting address of the buffer. For disk, flexible 
diskette, and magtape devices, this address must be on 
a word boundary. For all other devices, the buffer can 
begin on an odd address. (See the section "XRB 
(Transfer Request Block)" in Chapter 2 for more 
information. ) 

XRB+XRCI Channel number times two; defines the channel for the 
read, as previously defined in an open (OPNFQ, CRITFQ, 
CREFQ, or CRBFQ functions of CALFIP). 

XRB+XRBLKM For files on disk, this byte contains the MSB of the 
block number to begin the read. This byte is combined 
with the word at XRBLK to form a 24-bit field defining 
the block number. This byte is ignored for nondisk 
devices. 

XRB+XRBLK For channels opened as file-structured, this word 


defines the starting block number for this read. 
this word forms the LSB of the block 


large files, 


(For 


number to start the read.) The value performs the same 
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XRB+XRTIME 


- READ 


action as the BLOCK option for disk and the RECORD 
option for flexible diskette and non-file-structured 
DECtape (see the RSTS/E Programming Manual). Note that 
this word is ignored if the device is not a 
random-access device. 


If the device is random-access and this field is 
nonzero, it is interpreted as the block number where 
the read is to start (1 to n, where n is the length of 
the file, in 512-byte blocks). If the field is zero, 
the next sequential block is read. For example, if a 
disk file is being read with a 1024-byte buffer size, a 
~READ with this parameter equal to four would cause the 
fourth and fifth blocks of the file (512 bytes each) to 
be read into the buffer. 


For channels opened on disk as non-file-structured MODE 
0, this word defines the device cluster number where 
the read is to begin. In this case, each .READ begins 
with a new device cluster, so the buffer size at 
XRB+XRLEN should be a multiple of the device cluster 
size. 


If positive, the maximum time to wait for terminal 
input data, in seconds. Zero indicates an infinite 
wait. <A negative value (bit 15 equals 1) indicates an 
infinite keyboard monitor wait. This wait is used by 
run-time systems that act as keyboard monitors for 
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their command input. This type of wait time acts as a 
flag to the monitor and to the batch subsystem that the 
job is in a command input wait state. 


XRB+XRMOD Input operation modifier; significant only for card 
reader, terminal, DMC/DMR, or paper tape devices. (The 
monitor informs you with the FLGMOD bit of the flag 
word returned at FIRQB+FQFLAG on the open whether or 
not the device accepts modifiers.) This parameter 
performs the same action as the RECORD modifier in 
BASIC-PLUS for these devices (see the RSTS/E 
Programming Manual). 


Data Returned 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
+ oss es ee es ee ew ew ew ew ew ewe ee + -_—ses se we we we ewe wee ee ese eee ew + 
L|YSSSAIIIASIASIAII AAAS AAAS AAAS ASSIS SSS 17\ ® 
tere ree ee re eee ee eee Se + 
a actual number of bytes read | 2 XRBC 
| te t--- eee ee eee te ee eee + 
5 Vda 4 
Se + 
XRBLKM 7 | MSB of block number SLITS 6 
Sl Si + 
11 | LSB of block number where .READ began | 10 XRBLK 
Sr Sr + 
13 TEE SISSON ES SA ALLA EU le EAE EEL 12 
+ ses se ewe eee ewe ewe we ke ewe ke we ew we ew we ek we ew wee el hl ll wt hl hl th ell lc le ele + 
15 Udi 14 
+ a + 
XRB+XRBC Actual number of bytes just read. The value is between 


zero and the value of XRB+XRLEN passed in the XRB. If 
an error is returned on the read (as indicated by byte 
0 of the FIRQB), this word may or may not be zero. 
That is, data may be input even if an error occurs. 


For example, if the card reader detects an illegal card 
column punch combination, it places the decoded card 
data in the input buffer, substituting a special 
character for the bad column. The XRB+XRBC field is 
correctly set for the number of characters input, and 
an error is returned. 


XRB+XRBLKM For disk files, this byte contains the MSB of the block 
number just read. (See XRB+XRBLK. ) 


XRB+XRBLK For random-access devices (see Table 3-5), this word 
contains the block number of the block just input with 
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this .READ. Block numbers range from 1 to n (where n 
is the length of the file, in 512-byte blocks); they 

define the order in which the file was written. (For 
disks opened non-file-structured MODE 0, this is the 

device cluster number.) 


Errors 


The possible device-independent errors are: 


BADCNT The first three words of the XRB describing the input 
buffer are illegal. (Illegal byte count for I/O.) 

BSERR The specified channel number is illegal. 

NOTOPN No file or device is open on the specified channel 
number. 

PRVIOL The file or device open on the specified channel is 


write-only, or the caller did not obtain read access to 
the file or device when it was opened. 


All other errors are device-dependent. Some common errors are: 


DATERR Some data error occurred. There may or may not be any 
valid data in the input buffer. - This error is issued 
for parity errors, bad card columns, and so on. 


HNGDEV Some hard device I/O error occurred. There is usually 
no data in the input buffer when this error occurs. 
(For example, a .READ for an off-line device causes 
this error.) 


Example 


In this example, we assume that a disk file has been opened on channel 
2. Space for the buffer is allocated with the .BLKB directive, and 
the buffer size and location are defined. The next sequential block 
in the file is to be read (XRB+XRBLK is zero). 


BUFFER: .BLKB 512% ;ALLOCATE SPACE FOR BUFFER 
CALL CLRXRB 
MOV #512.,XRB+XRLEN ;SET BUFFER SIZE TO 512. BYTES 
MOV #BUFFER,XRB+XRLOC ;STARTING ADDRESS OF BUFFER 
MOVB #2*2,XRB+XRCI ;CHANNEL 2 FOR INPUT 
- READ 
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~-READA - Read Data from a Device (Asynchronous) 
Form 

- READA 
Function 


The asynchronous read directive (.READA) performs the same basic 
functions as the synchronous read directive (.READ): both move data 
between a device and a user program. The difference lies in the 
completion of the request. While synchronous read requests stall the 
job’s execution until the request completes, asynchronous read 
requests do not stall; the program continues to run while the I/O 
request completes in parallel with program execution. The mechanism 
that the RSTS operating system uses to notify the user job upon I/0 
completion is an asynchronous completion routine. 


Privileges Required 


TUNE is required to perform asynchronous read functions. 
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Data Passed 


Mne- Octal 
monic Offset 


1 


3 


37 


FIRQB+FQFIL 


FIRQB+FQPPN 


»READA 


Octal Mne- 


AERA SNEED LA SAA E SEL AMMAR AMAT 
WLLL 


Offset monic 


0 
2 
4 FQFIL 
6 FQPPN 
10 
12 
14 
16 
20 
22 
24 
26 
30 
32 
34 


36 


Identifies the address in the user job where program 


flow should begin when the asynchronous read completes. 


If FIRQB+FQFIL is zero, no AST completion routine is 
executed. In this case, it is understood that the user 
is using some other mechanism to determine whether the 


I/O request has successfully completed. 


This field is used by the user job to communicate 


information to the AST completion routine with the 


user’s program. If FIRQB+FQFIL is zero, 


ignored. 
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Mne- Octal 
monic Offset 


1 


3 


5 


XRBLKM 7 


15 


XRB+XRLEN 


XRB+XRBC 


XRB+XRLOC 


XRB+XRCI 


XRB+XRBLKM 


XRB+XRBLK 


XRB 
Octal Mne- 
Offset monic 
we ee ee eee eee tenn er ee ee ee ee ee et 
size of the buffer in bytes, must # 0 | O XRLEN 
wee eee ree eee eee eee teen eee ee ee ee eee ee et 
(must be 0) | 2 XRBC 
we ee ee eee eee ee Hern ee eee ee ee et 
starting address of buffer | 4 XRLOC 
we ee ee ee eee ee Se 
MSB of block number | channel number * 2 | 6 XRCI 
wr ee ee eee eee eee bee ee ee et 
LSB of block number to begin (0 = next) | 10 XRBLK 
were eee eee eee eee Henne ee ee ee eee ot 
wait time for terminal input | 12 XRTIME 
were ee eee eee eee teen ee ee ee ee et 
device-dependent modifier | 14 XRMOD 
wre ee eee ee eee eee Hern ee ee ee eet 


The length of the input buffer, in bytes. This word 
must be nonzero. The amount of data read depends on 
both the device and the buffer size. However, the 
amount of data can never be more than the buffer size. 
See Table 3-5 for details on reads for specific 
devices. 


This word must be passed as zero. The monitor returns 
the actual number of bytes transferred in this word 
location (see the Data Returned section). 


The starting address of the buffer. For disk, flexible 
diskette, and magtape devices, this address must be on 
a word boundary. For all other devices, the buffer can 
begin on an odd address. (See the section "XRB 
(Transfer Request Block)" in Chapter 2 for more 
information. ) 


Channel number times two; defines the channel for the 
read, as previously defined in an open (OPNFQ, CRTFQ, 
CREFQ, or CRBFQ functions of CALFIP). 


For files on disk, this byte contains the MSB of the 
block number to begin the read. This byte is combined 
with the word at XRBLK to form a 24-bit field defining 
the block number. This byte is ignored for nondisk 
devices. 


For channels opened as file-structured, this word 
defines the starting block number for this read. (For 
large files, this word forms the LSB of the block 
number to start the read.) The value performs the same 
action as the BLOCK option for disk and the RECORD 


3-196 


XRB+XRTIME 


XRB+XRMOD 


~READA 


option for flexible diskette and non-file-structured 
DECtape (see the RSTS/E Programming Manual). Note that 
this word is ignored if the device is not a 
random-access device. 


If the device is random-access and this field is 
nonzero, it is interpreted as the block number where 
the read is to start (1 to n, where n is the length of 
the file, in 512-byte blocks). If the field is zero, 
the next sequential block is read. For example, if a 
disk file is being read with a 1024-byte buffer size, a 
~-READA with this parameter equal to four would cause 
the fourth and fifth blocks of the file (512 bytes 
each) to be read into the buffer. 


For channels opened on disk as non-file-structured MODE 
0, this word defines the device cluster number where 
the read is to begin. In this case, each .READA begins 
with a new device cluster, so the buffer size at 
XRB+XRLEN should be a multiple of the device cluster 
size, 


If positive, the maximum time to wait for terminal 
input data, in seconds. Zero indicates an infinite 
wait. A negative value (bit 15 equals 1) indicates an 
infinite keyboard monitor wait. This wait is used by 
run-time systems that act as keyboard monitors for 
their command input. This type of wait time acts as a 
flag to the monitor and to the batch subsystem that the 
job is in a command input wait state. 


Input operation modifier. For disk asynchronous reads, 
a value of one in this byte indicates that a read check 
should be performed. A read check does not transfer 
any data. The buffer address specified in the XRB is 
compared with the data on the disk. 


Data Returned on Completion of the Directive 


No meaningful data is returned by the directive except for a possible 
error code in byte 0 of the FIRQB. Useful data is returned instead to 
the completion routine. 
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Data Returned to the Completion Routine 
FIRQB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 


1 OI, error code | 0 
3 VL job number x 2 | 2 FQJOB 
5 Vee 4 


7 | User- supplica parameter H 6 FQPPN 
Sl Sl + 


il IEEE URE LLALE RLU LAM ME AAA LED cele 10 
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XRB 
Mne- Octal . Octal Mne- 
monic Offset Offset monic 
Se tere eee ee ee ee ee eee eee + 
AMAA 
tee r ee eee Sr + 
3 actual number of bytes read | 2 XRBC 
tee ee eee eee eee eee Sr + 
) MARE Re AE SAAS MAGE ER AIEEE BAGH E MELD 4 
Se ee + 
XRBLKM 7 | MSB of block number DIB 6 
tener ree eee ee Se + 
11 | LSB of block number where .READ began | 10 XRBLK 
Se | + 
L3 |SSASASISSAIIIAIASLA SSAA AAAI AAA AAS AAAS S11 N2 
Si Se + 
15 OOO LE PE OE AOL EL 14 
Se + 
XRB+XRBC Actual number of bytes just read. The value is between 


zero and the value of XRB+XRLEN passed in the XRB. If 
an error is returned on the read (as indicated by byte 
0 of the FIRQB), this word may or may not be zero. 
That is, data may be input even if an error occurs. 


XRB+XRBLKM For disk files, this byte contains the MSB of the block 
number just read. (See XRB+XRBLK. ) 


XRB+XRBLK For random-access devices (see Table 3-5), this word 
contains the block number of the block just input with 
this .READA. Block numbers range from 1 to n (where n 
is the length of the file, in 512-byte blocks); they 
define the order in which the file was written. (For 
disks opened non-file-structured MODE 0, this is the 
device cluster number. ) 


Errors 

There are three classes of errors that can cause the failure of an 
asynchronous I/O request: directive errors; system-driver errors; and 
device-dependent errors. 

Directive errors are immediately visible upon examination of the FIRQB 
on return from the directive. These errors are Similar to the syntax 
errors checked by a compiler. If an error is found, the I/0 is not 
attempted, and the error is reported through the standard FIRQB+0 
mechanism. Some common directive errors are: 

BADCNT The completion routine address is invalid or odd. 


BSERR The specified channel number is illegal. 
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NOTOPN No file or device is open on the specified channel 
number. 
PRVIOL The file or device open on the specified channel is 


write-only, or the caller did not obtain read access to 
the file or device when it was opened. 


System-driver errors occur before the asynchronous request is issued 
to the appropriate device driver. These errors are related to the 
lack of system resources, for example: 


INUSE Too much outstanding I/O for the job (over quota). 
NOBUFS The system could not get a small buffer for the 
request. 


Any of the previous errors are reported on return from the .READA 
directive. If none of these errors occurred, the read operation is 
started and the directive returns a value of 0 in FIRQB+0. The read 
operation may still fail at a later point; its success or failure is 
indicated in FIRQB+0 when the completion routine is entered. 


Other system-driver errors are reported within the AST completion 
routine: 


EOF End-of-file (EOF) on the specified device. 
NOROOM No room for the user on the specified device. 


Device-dependent errors can only be found during the attempt of the 
actual I/O transfer. These errors can only be reported to the job in 
the asynchronous I/O completion routine. Some common device-dependent 
errors are: 


DATERR Some data error occurred. There may or may not be any 
valid data in the input buffer. This error is issued 
for parity errors, bad card columns, and so on. 


HNGDEV Some hard device I/O error occurred. There is usually 
no data in the input buffer when this error occurs. 
(For example, a .READA for an off-line device causes 
this error.) 


Example 


The following example performs an asynchronous disk-to-disk copy. The 
program initially issues three read requests (.READA) on the first 
disk and issues a corresponding write request (.WRITA) on the second 
device when each .READA completes. After each .WRITA completes, 
another advanced .READA is issued. Thus, there is always one 
outstanding .READA and at least one outstanding .WRITA. Each new I/0 
request within the routine uses the same buffer address as the request 
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' that has just finished. 
buffers. 


Note that the program does not handle bad 
it prompt for the disk specifications. 
fatal. 


Register usage: 
R2 = Input block number 
R4 = 


=e te WO 


- READA 


This is an easy way to keep track of the free 


blocks efficiently; nor does 


All errors are treated as 


Buffer number (carried in the user-created parameter field) 
-PSECT CODE 
START: CALL CLRFQB : Clear FIRQB 
; 
; Open input disk device = DLO: 
; 
MOVB #OPNFQ, FIRQB+FQFUN ; Function code 
MOVB #3*2,FIROB+FOFIL ; Set input channel = 3 
MOV #"DL,FIRQOB+FQDEV : on an RLO2 
MOV #377*400+0,FIROB+FQDEVN ; unit 0, device real 
MOV #200*400+8192.,FIRQB+FQMODE ; read-only mode 
CALFIP ; Go for it 
MOV FIRQB,RO ; Error? 
BNE FATAL ; Stop and check it out 


Open output disk device = DLI1: 


=e we we 


MOVB #OPNFQ, FIROB+FOFUN : 
MOVB #4*2,FIROB+FOFIL : 
MOV #"DL,FIRQB+FQDEV ; 
MOV #377*400+1,FIRQB+FQDEVN 
CALFIP ; 
MOV FIRQB,RO ; 
BNE FATAL 2 

t 

; Issue the first three initial reads 

a 
CALL CLRFQX ‘ 
MOV #3,R1 ; 
CLR R2 : 
MOV #BUFFER,R4 : 

10S: MOV #512.,XRB+XRLEN : 
CLR XRB+XRBC ; 
MOV R4,XRB+XRLOC ; 
MOVB #3*2,XRB+XRCI 2 
INC R2 ; 
MOV R2,XRB+XRBLK ; 
MOV #RSAST, FIRQB+FQFIL : 
MOV R4,FIRQB+FQPPN 4 
- READA : 
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Function code 

Set output channel = 4 
on an RLO2 
- unit l, 

Go for it 
Error? 

Stop and check it out 


device real 


Clear FIROB & XRB 

1 read + 2 read-aheads 
Start at virtual block zero 
Load lst buffer address 


Set buffer size to 512. 
XRBC = 0 

Set our next buffer address 
Input channel times 2 

Next input block number 
Read that block 

Go to RSAST after read 
User-created parameter 

Do an asynchronous read 


-READA 


208: 


; 
;All .READA’s come here at completion 


; 
RSAST: 


60S: 


SAST: 


3 =e 66 6S 


708: 


° 
’ 


MOV 
BNE 
ADD 
SOB 


MOV 
- SLEEP 
BR 


MOV 
BEQ 
CMPB 
BEQ 
BR 


MOV 
MOV 
MOV 
MOVB 


MOV 
-WRITA 
BR 


MOV 
BEQ 
CMPB 
BEQ 
BR 


MOV 
CLR 
MOV 
MOVB 
INC 
MOV 
MOV 

- READA 
BR 


FIRQB, RO 
FATAL 
#512.,R4 
R1,10$ 


#100001, XRB+0 


20$ 


FIRQB, RO 
60$ 
#13,R0 
CLSIN 
FATAL 


#512.,XRB+XRLEN 
#512.,XRB+XRBC 


FIROB+FOPPN,XRB+XRLOC 


#4*2,XRB+XRCI 


#WSAST, FIRQB+FQFIL 


ASTDON 


FIRQB,RO 
70$ 
#13,R0 
CLSIN 
FATAL 


#512.,XRB+XRLEN 


XRB+XRBC 


FIRQB+FQPPN, XRB+XRLOC 


#3%*2,XRB+XRCI 


R2 


R2,XRB+XRBLK 
#RSAST, FIRQB+FQFIL 


ASTDON 


; AST common code 


, 
ASTDON: 


-SBTTL 


MOV 
BNE 
~-ASTX 


FIRQB,RO 
FATAL 


FIRQB/XRB clearing 


routines 


3-202 


Directive error? 

Yes, stop 

Get next buffer address 
Issue next read-ahead 


=e se TO TS 


; Conditional sleep 
; and do that until done 
time 


Error? 

No, continue 

End-of-disk (EOD) ? 

Yes, close I/O disks 

No, unexpected error, stop 


=e “Neo Se MO SO 


Reset buffer size 

Want to write entire buffer 
Use the same buffer address 
Output channel * 2 

XRBLK has block number 
Completion routine address 
Write that block 

Join the common code 


=e “™e Me Me Ne SSO WS TO 


All .WRITA’s come here at completion time 


Error? 

No, continue 

End-of-disk (EOF) ? 

Yes, close I/O disks 

No, unexpected error, stop 


=e “ee “Oe Me NO 


Set buffer size 

XRBC = zero 

Use the same buffer address 
Input channel * 2 

Increment to next block 
XRBLK has block number 
Completion routine address 
Read that block 

Join the common code 


=e ~e Te Ve MOA VO VO VO Ve 


Any directive errors 
Yes, stop 
No, just return to mainline 


=e “Se “MO 


. ENABL 


CLRFQX: 


CLRFQOB: 


CLRXRB: 


2008S: 


; 
; Errors (code in RO) 
; 


CLSIN: 


-PSECT 


BUFFER: 


BUFEND: 


» END 


LSB 


PUSH 
MOV 
MOV 
BR 


PUSH 
MOV 
MOV 
BR 


PUSH 
MOV 
MOV 


CLR 
SOB 
POP 
RETURN 


- EXIT 


<RO,R1> ; 
#FIRQB, RO ; 
#<<FQBSIZ+XRBSIZ>/2>,R1 
20098 


<RO,R1> 
#FIRQB,RO 
#<FQBSIZ/2>,R1 
200$ 


=e Be MO 


<RO,R1> 
#XRB,RO 
#<XRBSIZ/2>,R1 


~=e we tO 


(RO)+ 
R1,200$ 
<R1,RO> 


~e we we 


come here 


=e tO 


-READA 


Save RO, Rl 
Point to FIRQB 
; Compute how many words 


Save RO, Rl 
Point to FIRQB 
Compute how many words 


Save RO, Rl 
Point to XRB 
Compute how many words 


zero it out 
Until all done 
Restore RO, Rl 


All errors come here 
All done 


input disk (may still have outstanding .READAS) 


CALL 
MOVB 
MOVB 
CALFIP 


CLRFQB 


; 
#CLSFQ, FIRQB+FQFUN ; 
#3%*2,FIRQB+FOFIL ; 

; 


Clear FIRQB 
CLOSE function 
Set channel = 3 
Do it 


output disk (may still have outstanding .WRITAS) 


CALL 
MOVB 
MOVB 
CALFIP 
BR 


DATA 
- BLKB 


- BLKB 
- BLKB 


START 


CLRFQOB 
#CLSFQ, FIRQB+FQFUN 
#4*2,FIRQB+FQFIL 


~e te VO BME WO 


OUT 


SiZ. 
512. 
512. 
; Address for EOB 


=e ‘* eNO 
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Clear FIRQB 
CLOSE function 
Set channel = 4 
Do it 


Then, exit 


Buffer one 
Buffer two 
Buffer three 


-RTS 


-RTS - Pass Control to Run-Time System 
Form 

-RTS 
Function 
The .RTS directive passes control to a run-time system at the P.NEW 
entry point, where the intent is not to run an executable file (see 
Chapter 2). .RTS performs one of four functions: 

o Passes control to the job’s keyboard monitor 


o Passes control to a named run-time system 


o Passes control to a named run-time system and establishes it 
as the job’s keyboard monitor 


o Passes control to a named run-time system without changing 
job context information 


The first function is generally part of a run-time system’s exit 
processing; you do not normally use .RTS for this purpose in a user 
program. The following code shows how .RTS is used in exit processing 
(for example, in the RT11 run-time system’s .EXIT directive): 


EXIT: CALL CLRFQB ; Clear FIRQB 
.RTS > Exit to default KBM 
JMP PROMPT ; If that’s this KBM, then 
7 


prompt for another command 


The other three functions of .RTS apply to both user programs and 
run-time systems. 


Note that once established, a job’s keyboard monitor replaces the 
default keyboard monitor as the one to which control passes by 
default. This concept is best explained by example. 


The SET JOB/KEYBOARD_MONITOR command uses the .RTS directive to 
establish the run-time system to which it passes control as the job’s 
keyboard monitor (see the RSTS/E System Manager’s Guide). Consider 
the following sequence: 


S$ SET JOB/KEYBOARD_MONITOR=RT11 
- MAC 

MAC>CTRL/C 

~CTRL/C 

-SSET JOB/KEYBOARD_MONITOR 


$ 
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The first line shows the DCL prompt ($), indicating that the user is 
in the DCL keyboard monitor. Then: 


l. 


The four 


oO 


The user executes the SET JOB/KEYBOARD_MONITOR command to 
pass control to the RTl1 run-time system. This command 
establishes RT1ll1 as the job’s keyboard monitor. The RT1l 
run-time system displays the period prompt. 


The user runs MAC, the RSX assembler. Control passes to the 
RSX emulator, which loads the assembler and runs it. MAC 
displays the "MAC>" prompt. 


The user, realizing the mistake in typing MAC instead of 
MACRO, enters CTRL/C to exit. Since RT1ll has been 
established as the job’s keyboard monitor, control passes 
back to RT1l1, and it displays the period prompt. 


The user, wanting to get back to DCL, enters another CTRL/C. 
Since RT1l is the job’s keyboard monitor, however, another 
period prompt appears. 


The user finally issues the SET JOB/KEYBOARD_MONITOR command 
(with the $ prefix to indicate that it is a DCL command), 
leaving out the run-time system name. This command transfers 
control back to the system default keyboard monitor (DCL), 
establishing it once again as the job’s keyboard monitor. 


cases in which the .RTS directive can be used are: 


In the first case, the .RTS directive is used to switch 
control back to the run-time system already established as 
the job’s keyboard monitor. In this case, the name of the 
run-time system is not known. The word in the FIRQB that 
would contain the first part of the run-time system name is 
zero. If the run-time system that issues the .RTS is not 
itself the job’s keyboard monitor, or the currently running 
program is a privileged program, control is passed to the job 
keyboard monitor at entry point P.NEW. If the run-time 
system that issues the .RTS is the job’s keyboard monitor and 
the current program is not a privileged program, control 
returns to the instruction following the .RTS with no error 
indicated. 


In the second case, the .RTS directive is used to switch 
control to the run-time system named in the FIRQB. (Run-time 
systems are made known to the monitor by the system manager 
with the INSTALL/RUNTIME_SYSTEM command. With this command, 
the system manager defines a file (filename.RTS) as an 
auxiliary run-time system. The monitor regards "filename" as 
the run-time system’s name.) If the run-time system that 
issues the .RTS directive is not itself the named run-time 
system, or the currently running program is a privileged 
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program, control passes to the named run-time system at the 
P.NEW entry point. If the run-time system that issues the 
-RTS directive is the named run-time system and the current 
program is not a privileged program, control returns to the 
instruction following the .RTS with no error indication. If 
the named run-time system does not exist or is not available 
for some reason, control returns to the instruction following 
the .RTS with an error in byte 0 of the FIRQB. 


o In the third case, the .RTS directive is used to switch 
control to a named run-time system and establish it as the 
job’s keyboard monitor. If the run-time system that issues 
the .RTS is not itself the named run-time system, or the 
currently running program is a privileged program, control 
passes to the named run-time system at the P.NEW entry point, 
and the named run-time system is established as the job’s 
keyboard monitor. If the run-time system that issues the 
-RTS names itself as the run-time system and the current 
program is not a privileged program, control returns to the 
instruction following the .RTS with no error, and the 
run-time system is established as the job’s keyboard monitor. 
If the named run-time system does not exist or is 
unavailable, control returns to the instruction following the 
-RTS with an error in byte 0 of the FIRQB. 


o In the fourth case, the .RTS directive is used to switch 
control to a named run-time system preserving the job’s 
current job-context information. Control passes to the named 
run-time system at the P.NEW entry point, but the monitor 
does not refresh the keyword, reset the stack pointer, or 
perform any of the initialization operations (see the 
discussion of P.NEW in Chapter 2). 


In the first three cases, if the program currently running had 
temporary privileges in effect at one time (whether it has since 
dropped them or not), then the transfer of control to the P.NEW entry 
point is unconditional. In addition, all of the user’s memory above 
NSTORG is cleared to ensure any restricted data kept by the program is 
erased from memory. Finally, the monitor drops temporary privileges. 


Note 


Do not use this directive from programs running under 
the RT1l1 run-time system, because RT11 uses the 
lowest 512 bytes differently than other run-time 
systems. The correct way to terminate a program 
running under RT1ll is to exit through the RT11 
emulator. 


Although you can use this directive to terminate a 
program running under the RSX run-time system, 
DIGITAL recommends that you use the RSX EXITS or 


3-206 


-RTS 


EXSTS directive instead (see Chapter 5). Using .RTS 
May cause unexpected results. 


Privileges Required 
None 
Data Passed 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 AE SEE A LENA LAA ad ALi hcl 0 
3 Ueda 2 


11 | run-time system name | 10 FQNAM1 
13 | (2 words of RAD50) | 12 


15 | -1, Switch Kbm.; -2, don’t change context | 14 FQEXT 


37 QL 36 


FIRQB+FQNAM1 If control is being passed to a named run-time system 
(cases 2, 3, and 4 described previously), the name of 
the run-time system is stored as two words in RAD50 
format beginning here. If control is being passed to 
the job’s keyboard monitor (case 1), the word beginning 
here must contain a value of zero. 
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FIRQB+FQEXT To establish a named run-time system as the job’s 
keyboard monitor (case 3), set this word to -l. To 
switch control to a named run-time system without 
altering job-context information (case 4), set this 
word to -2. When the word at FIRQB+FQNAM] is zero, 
this word is ignored. 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tenn ee ee ee ee ee ee pe ee ee ee ee ee ee ee eee + 
1 UZ 0 
Se ee + 
3 ULL 2 
Se i ie eee + 
) VL 4 
Se i + 
7 VL 6 
Oe + 
ll | | 10 XRBLK 
+ + 
3 unaltered whether or not | 12 
+ control passes to new run-time system + 
15 | | 14 
Se Se + 
XRB+XRBLK The three words starting at this location pass 


unaltered to the new run-time system. They are also 
unaltered if control returns in line. 


Data Returned 


Since control usually passes to some other run-time system at its 
P.NEW entry point, no arguments as such are returned by .RTS. The 
three words starting at XRB+10 remain unaltered if control returns in 
line. 


Errors 
NORTS No run-time system exists with the specified name. 
PRVIOL The named run-time system does exist but cannot be 


switched to for some reason. (For example, if the 
switch is made to a named run-time system with the 
intent of establishing it as the job’s keyboard monitor 
and its PF.KBM bit in the P.FLAG word is not set to l.) 
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‘Example 


The following example establishes NEWRTS (which the system manager 
must have installed with INSTALL/RUNTIME_SYSTEM/KEYBOARD_MONITOR 
command) as the job’s keyboard monitor: 


MOV #° RNEW, FIROB+FQNAM1 ; Set run-time system 
MOV #* RRTS, FIRQOB+FQNAM14+1 ; Name to "NEWRTS" 

MOV #-1,FIRQB+FOQEXT ; Establish as job kbm 
-RTS 
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-RUN ~- Run a Program 
Form 

- RUN 
Function 


The .RUN directive searches for a binary (executable) file (defined in 
the FIRQB), opens it on channel 15, and passes control to the P.RUN 
entry point of the run-time system associated with the file. The 
associated run-time system is identified in the file’s directory 
information. This directory information is initially set to indicate 
the run-time system under which the file was created. The system 
Manager can change the run-time system associated with the file with 
the SET FILE/RUNTIME SYSTEM command (see the RSTS/E System Manager’s 
Guide). 


The run-time system is responsible for loading and executing the file 
(see the P.RUN description in Chapter 2). Control is not returned in 
line unless an error occurs. The monitor drops any temporary 
privileges in effect under the previously running program. 

Privileges Required 


File execute access required; either by protection code or privilege 
(GREAD or WREAD). 
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‘Data Passed 


Mne- Octal 


monic Offset 


-RUN 


FIRQB 
Octal Mne- 
Offset monic 
weet eet ee ee ee ee eee tere ee ee eee ee ee ee ee et 


1 NO OO ee | 0 
3 Vad 2 


+--- 


ee + 
project number i programmer number | 6 FQPPN 

were eee ee eee eee Sr 7 
file name in RAD50 format | 10 FQNAM1 

+ 

(2 words) | 12 

we ere eee ee eee tere ee ee ee ee et 
file type in RAD50 format (1 word) | 14 FQEXT 

we ee eee eee eee Se 7 


17 CUR ANA GRE SEA AGIA L SAMA KALE 16 
21 Vdd 20 
23 Vdd 22 
25 UZ adadadiddida 24 


Sn as + 
27 Veaaaddaaaadaidiiia 26 
Sn as + 
31 | device name (2 eu characters) | 30 FQDEV 
tenner eee ee ee ee eee eee Se + 
33 | #0, unit no. real | device unit number | 32 FQDEVN 
Se terre eee eee ee ee eee eee + 
35 LLLLLLLLLLLLLLLLLLLLLL LLL LLL LL LLL LL LL LLL LL \ 34 
Heer eee ee ee ee ee eee terre ee ee ee ee ee eee eee + 
a7 | entry parameter | 36 FQNENT 
Se terete eee eee eee eee eee + 
FIRQB+FQPPN The PPN of the file to be opened. The project number 
is specified in the high byte, the programmer number in 
the low byte. If this word is passed as zero, the PPN 
defaults to the PPN of the job that issues the .RUN 
directive. 
FIRQB+FQNAM1 The file name of the file to be opened; two words in 
RAD50 format. 
FI RQB+FQEXT The file type for the file to be opened; one word in 


RAD5O format. If you set this word to -l, the monitor 
will search for the file name supplied, substituting 
the default file type for the currently installed set 
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of run-time systems until a file with the given name 
and one of the default file types is found. 


FIRQB+FQDEV The device name of the file to be opened, as two ASCII 
characters. If the device name is not a disk, the .RUN 
directive returns in line with one of the soft errors 
described in the Errors section. If you pass a full 
word of zero here and in FIRQB+FQDEVN, the public disk 
structure (SY:) is searched for the named file. 


FIRQB+FQNENT A 16-bit parameter word can be passed to the run-time 
system here. If the calling program has temporary 
privileges in effect, bit 15 is unchanged. Otherwise, 
bit 15 is cleared. The monitor takes no other action 
as a result of the contents of this word; any 
processing is up to the run-time system. (See the 
P.RUN entry point, Chapter 2.) 


Errors 


When an error occurs in a .RUN, FIRQB+FQFLAG is set to zero to 
indicate a hard error or -1l to indicate a soft error. 


A hard error means the .RUN failed. A soft error also means the .RUN 
failed, but the run-time system may be able to recover. For example, 
when you use the BASIC-PLUS RUN command, BASIC-PLUS first executes a 
-RUN. If the .RUN returns a soft error, BASIC-PLUS performs an OLD 
(which compiles the program) and then executes .RUN again. 


Hard Errors 


BADNAM The specified file name was zero. This is an illegal 
file name for disk files. 


DEVNFS The specified disk device is currently being used 
non-file-structured. 


NOTCLS Channel 15 is currently open. It must be closed before 
any .RUN call. (This error occurs only if channel 15 
is open on a nondisk device. If a disk file is open, 
the channel is closed automatically.) 


NODEVC The specified device does not exist or is in an illegal 
format. 
NORTS The run-time system named in the file’s directory 


information has not been installed. 
NOTMNT The specified disk device is not now mounted. 


PAKLCK The disk pack on which the file exists is locked 
against further file opens. 
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‘Soft Errors 


NOSUCH The file was not found. Note that if FIRQB+FQEXT was 
~l in the data passed, the monitor has looked for the 
given file name with all default runnable file types 
for the currently installed run-time systems. In this 
case, a source version of the file may still exist. 


PRVIOL The device is not disk but is still a legal device on 
the system. Or the file was found and is on disk but 
does not have the compiled program bit set in its file 
protection code (bit 6). 


Example 


The following example uses the .FSS directive to translate a 
user-typed string to the FIRQB format. If no errors in the .FSS 
occur, a test is made to see if a file type was specified. If not, a 
-l is supplied in FIRQB+FQEXT so the monitor searches for the given 
file name with all possible default file types that are runnable. 


(read user-typed line, set up FIRQB for .FSS) 


~FSS 
TSTB FIRQB ; Error on .FSS? 
BNE ERRTN ; Branch to process error 
BIT #100000, XRB+XRBLK s Invalid device name? 
BNE BADDEV ; Branch to process error 
BIT #10,XRB+XRBLK ; File type given? 
BNE SKIP1 ; Yes, skip next 
MOV #-1,FIRQB+FQEXT : No, search all 

SKIP1: CLR FIRQB+FQNENT ; Entry parameter is zero 
.RUN 
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~SET - Set Keyword Bits 
Form 
SET 
Function 
The .SET directive sets certain bits in the keyword (KEY) location in 
the user job image (see Chapter 2). The bits to be set are passed to 
the monitor in the XRB. 
Privileges Required 


TUNE is required to set the special run priority bit (JFSPRI) or the 
lock in memory bit (JFLOCK). 


Data Passed 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
perc eee ee ee eee ee eee eee tere ee ee ee eee ee ee ee eee + 
1 | bits to be set are set to l here | O XRLEN 
perce ee eee eee ee ee eee tence ee eee ee ee eee ee eee + 
3 AEE EEA EEK DEAL Ala le CEES ASM 2 
ter ee ee epee ee ee ee ee ee ee eee ee + 
5 A PLLLPAILPPLLSLAPLSIPPSSPA APSA ASSLPPLPP SLL | 4 
tonne ce ee eee eee ee ee eee tere ee ee ee ee ee ee ee eee + 
7 EN IEEE S GRAMM ER ASAE EDREAMS 6 
herr ee ee ee ee epee ee ee ee ee ee ee ee eee + 
11 Vea 10 
i in i i i i ii iain. + 
13 Veaaaadaaaaaaaididdda 12 
Harn ee ee epee ee ee ee eee ee ee eee + 
15  LPPLSPPALLPPALSS PASTS SAA PSSSA PSSA PAIS ALS 14 
ia tere ee eee ee eee ee eee eee + 
JFSPRI--------- + 
JFFPP--------- + | 
JFPRIV------- + | | 
JFSYS------- + | | | 
JFNOPR----- + | | | | 
JFBIG----- + | | | | | 
JFLOCK- | | | | | | 
| | | | | | 
15 14 #13 12 #11 «10 9 8 | 7 6 5 4 3 2 l 0 
ee ee SR SS sO ee See See See See © 
| | | | | | | | | | | | | | | | | 
Se ee Se SR Ss Oe Os eS Sn Se Se Se See Sos 
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' JFLOCK Can be set only by jobs with TUNE privilege. When this 
bit is set, the monitor swaps the user job image out of 
memory only when: 


o The job issues a .CORE directive to expand the 
memory allocated for the user job image, and there 
is not sufficient room in physical memory to do the 
expansion. In this case, the job is swapped out to 
disk and back in at the indicated size. 


o A fatal error, such as a memory parity failure, 
occurs. 


JFBIG Cannot be set by any job; masked off, that is, the 
corresponding bits in KEY cannot be set by the job with 
the .SET directive. 


JFNOPR Cannot be set by any job; masked off. 


JFSYS Can be set by a job only if JFSYS was set at one time 
and the temporary privileges gained were only 
temporarily dropped. (See description of KEY, Chapter 
2 and the .CLEAR directive.) 


JFPRIV Cannot be set by any job; masked off. 


JFFPP Can be set by any caller if the PDP-11/45 compatible 
hardware floating-point unit exists; masked off if it 
does not exist. When this bit is set, the monitor will 
save information in the floating-point unit as part of 
the job-context information kept when jobs are swapped 
in and out of memory. 


JFSPRI Can be set only by a caller with TUNE privilege. 
Setting JFSPRI raises the job’s run priority by 

one-half step. (That is, it sets bit 2 of the 
system-controlled low-order three bits of the run 
priority. Priorities are normally set by the system 
manager.) 

All other bits in the XRB word are masked off. 

Data Returned 


The .SET directive does not return any meaningful data. 
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Errors 


No errors are possible with the .SET directive. 


Example 


The following code sets JFLOCK, allowing the job to remain locked in 
memory: 


MOV # JFLOCK,XRB+XRLEN ;SET JFLOCK 
- SET 
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~-SLEEP - Suspend Job 
Form 

. SLEEP 
Function 
The .SLEEP directive causes the monitor to suspend the job for some 
specified time interval or until an event occurs that the job should 
be aware of. Optionally, the monitor checks, before the job is 
suspended, to see if some event has already occurred which would cause 
it to awaken. If so, the job is not suspended. Control returns in 


line in either case. 


When a .SLEEP is executed, execution of the job is suspended until one 
of the following happens: 


o The sleep time (specified in the XRB) expires. 

o A local or network message is queued for the job assuming 
that the job is using local or network send/receive services. 
(See the .MESAG directive. ) 


o A delimiter is typed on a terminal that this job has opened 
or assigned. 


o The system manager disables logins. (This could occur if the 
system is being shut down.) 


o A state change occurs on a pseudo keyboard assigned to the 
job. (The job has printed output for the controlling job to 
read or has entered an input wait state.) 


o The DMC11/DMR11 driver (XM:) is open and a message is pending 
for the job. 


o An AST completion is queued. 


If you request it, the monitor checks for the following conditions 
before suspending the job: 


o A delimiter has been typed on any terminal opened by the job 
or any terminal assigned to the job if the job also has a 
keyboard open on a nonzero channel. 


o A message has been queued for the job. 


o A state change has occurred on a pseudo keyboard opened by 
the job. 
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o The job has a DMC11/DMR11 device driver open and a message 
has been received by that device driver. 


o One or more AST completion routines are pending. 
If the monitor determines that any of these conditions are true, it 
does not execute the .SLEEP. This feature is known as conditional 
sleep. 
Data Passed 
XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 | sleep time, in seconds | 0 XRLEN 
ZS USSAAIAIISIAAAIAIIAAI AISA IAA SAA AAAS AS AAAS \ 2 
5 USA EAE EAS MILE SELLE S 5 CA eR le ae 4 
7 Vad 6 
11 SP LLLLLILLILI PLIST LIL LILTPL IPT ALTIT ILIAD TLE 10 
13 WO 12 
15 Vad 14 
XRB+XRLEN This word defines the sleep interval, in seconds. If 
the value is zero, then .SLEEP returns immediately. If 
bit 15 is set, the monitor performs the conditional 
Sleep checks. If any of the previously listed 
conditions are present, the .SLEEP is not executed. 
Data Returned 
The .SLEEP directive does not return any meaningful data. 
Errors 
No errors are possible with the .SLEEP directive. 


Example 


MOV #5,XRB+XRLEN ; Set timer to 5 seconds 
- SLEEP 
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e-SPEC - Special Functions for I/0 


Form 


(set XRB for special function) 


.SPEC 
Function 
The .SPEC directive performs special functions for: 
o Disks 
o Flexible diskettes 
o Line printers 
o Magnetic tapes 
o Pseudo keyboards 


o Terminals 


~SPEC 
(Disk) 


-SPEC for Disk 


For disk, the .SPEC directive lets you explicitly lock up to seven 
disk blocks on a file open for update (mode parameter). A locked 
block cannot be accessed by another user (or from another channel). 
This extends the implicit lock feature, by which the last block or 
blocks read on a file open for update cannot be accessed by anyone 
else. The disk special functions also let you release explicit and 
implicit locks. (All locks, both explicit and implicit, are released 
when the file is closed.) 


There is also a .SPEC option to perform a comparison operation between 
the contents of a buffer and one or more blocks of a disk file. 


Privileges Required 
None 


Data Passed (Disk - Except Compare) 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tren re ee eee ee ee eee Se + 
1 | special function code | O XRLEN 
Sc Sr + 
3°; LSB of block number (release) | 2 XRBC 
ee teeter re ee ee ee ee eee eee + 
DS ISSASSIIIL1111////7///\4MSB of block no. (rl)| 4 XRLOC 
tert tee ee eee ee eee Here ere ee ee eee ee eee + 
XRBLKM 7 | DSKHND (=octal 0) =| channel number * 2 | 6 XRCI 
Horr ee ee ee ee eee tee en eee ee eee eee eee + 
LL YSSSAASASAIAAIAAAIA AAAI AAA AAAS AAA AAAS A111 77 \ 10 
i tee eee ee eee ee eee ee eee + 
L3 |SSLIIAIAIIIAAAISAAAA AAAI AAA AAA AAA AAA AAA \ 42 
tree eee eee ee eee eee terre eee eee eee eee eee + 
15 A A CE el RGA MEL GREASE EM ne GRAAL 14 
Se + 
XRB+XRLEN Defines function to be performed: 
Code Meaning 
0 Release any implicit lock and all explicit locks. 


The monitor deallocates the extended internal 
table space it needed to do the explicit locks. 
(See code 3.) 

1 Release implicit lock. 


2 Make implicit lock into explicit lock. 
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XRB+XRBC, 
XRB+XRLOC 


XRB+XRCI 


XRB+XRBLKM 


SPEC 
(Disk) 


Release the explicit lock on the block specified 
by the word at XRB+XRBC (LSB) and the byte at 
XRB+XRLOC (MSB). If all three bytes are zero, all 
explicit locks are released, but the monitor does 
not deallocate the extra space needed to do 
explicit locks. (This is useful if you intend to 
use the explicit lock feature again during this 
run. An error occurs if no space is available for 
this purpose.) 


Make implicit lock into explicit lock and release 


the implicit lock. 


Both these bytes specify the starting block number for 
releasing an explicit lock. If these bytes are zero, 


all explicit locks are released, but the monitor 


retains the extended table area it needs to maintain 
these locks. (This is useful if you want to use this 


capability again during a run.) 


Channel number times two; defines the channel for the 


lock/unlock operation. 


Handler index for disk: DSKHND (octal value = 0). 


Data Passed (Disk - Compare) 


Mne- Octal 
monic Offset 


1 | 
3 | 
5 | 


XRBLKM 7 | 


XRB 
Octal Mne- 
Offset monic 
wee eee eee eee eee eee Henn ee eee ee ee ee et 
-1 | 0 XRLEN 
wee eee ee eee ee eee ce | 
buffer size | 2 XRBC 
wee ee ee ee ee eee Se. 
buffer address | 4 XRLOC 
wr ee ee ee eee eee tener ee ee ee ee et 
DSKHND (=0) | channel number * 2 | 6 XRCI 
wee ee ee ee ee eee Se | 
LSB of block aoa: to begin compare | 10 XRBLK 


13 WZ 12 


15 vee orn MSB of block number | 14 XRMOD 


XRB+XRBC 


XRB+XRLOC 


XRB+XRBLK 


Size of the data buffer to be compared. 
Address of the data buffer to be compared. 


LSB of the first block number on the disk to be 
compared with the data buffer. 


SPEC 
(Disk) 


XRB+XRMOD MSB of the first block number on the disk to be 
compared with the data buffer. 
Data Returned 


Except for a possible error code in byte 0 of the FIRQB, the disk 
subfunctions of .SPEC do not return any meaningful data. 


Errors 


For subfunction code 2: 


INTLCK Occurs if the implicit lock overlaps any current 
explicit lock. For example, if you read blocks 1 and 2 
into a 1024-byte buffer in update mode, an implicit 
lock exists on blocks 1 and 2. If you explicitly 
locked these blocks, and then read blocks 2 and 3 and 
tried to explicitly lock blocks 2 and 3, you would get 
this error. An exact match is legal (for example, if 
the second read also read blocks 1 and 2) and results 
in a no operation. 


NOBUFS Occurs if the monitor needs to expand its internal 
table space but memory is not available. 


NOROOM There are already seven explicit locks on this channel. 


PRVIOL There is no current implicit lock; that is, no blocks 
have been read. 


For subfunction code 3: 


NOSUCH The block number specified does not correspond to the 
first block number of an explicit lock. 


For subfunction code -l: 


DATERR The data in the buffer does not match the data on the 
disk. 
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-SPEC for Flexible Diskette 
For RX02 flexible diskette devices, the .SPEC directive lets you: 


o Obtain the density (single or double) of the current flexible 
diskette 


o Mount a new flexible diskette and recompute the density 
oO Reformat an RX02 flexible diskette for a desired density 


Because the RX02 flexible diskette drive supports single and double 
density flexible diskettes, the .SPEC function is especially useful 
for programmed flexible diskette operations. For example, .SPEC 
allows you to mount a series of single and double density flexible 
diskettes without having to close and reopen the device for each 
mount. Normally, the driver computes density once: during the 
initial open. If you insert a second flexible diskette that is 
incompatible with the initially computed density, a read or write 
operation fails. .SPEC lets you include an instruction in your 
program that causes the driver to recompute the density. In addition, 
for RX02 flexible diskette drives, .SPEC permits you to specify a 
density reformat operation. 


-SPEC can require as much as 20 seconds to reformat the density of the 
RX02 flexible diskette and cannot be interrupted with CTRL/C. Note 
that if the operation is interrupted (by power failure or catastrophic 
error), the flexible diskette is rendered unusable. That is, the 
flexible diskette contains both single and double density. To 
recover, you must reformat the flexible diskette. 


Privileges Required 


None 
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(Line Printer) 

-SPEC for Line Printer 
Privileges Required 
None 


Data Passed (Line Counter Subfunction) 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
os a + 
1 | = 0 for line counter | QO XRLEN 
tere nee eee ee ee ee ee eee terete eee ee ee ee eee eee + 
ZB LSSSIIIIIAIAIAAIAIAAA AAAS AAA AA AAA A A RBC 
Herre eee ee eee eee eee terre ee eee ee eee eee + 
DS ISASSAAAIAIAA AAAI AAS AAAS AAAS AAA ASA AS AAA AAA |) 4 ®RGOC 
tener ee eee ee eee eee eee ten ee ee eee eee eee ee eee + 
XRBLKM 7 | LPAHND (= 6) | channel number * 2 | 6 XRCI 
tener eee ee ee eee eee eee ten eee eee eee ee ee eee ee + 
LL |SSSASSAASIIIIIAAAAAA AAAS AAAS AAAS AAA AAA AAA / |) 10 XRBLK 
penne ee eee eee ee eee eee tener ee ee ee ee ee ee eee + 
L3 (SSASSSIIIIIISIISAIA AAAI AAA AAS AAAS ASA /\ N2 
tere ee eee eee ee eee eee terre eee ee ee ee eee eee + 
LS USSSA AAAI AAAS AAAA AAA AA AAAS AAAS A174 V4 
terre ee ee eee eee ee ee eee ten eee eee eee ee eee ee ee + 
XRB+XRLEN The special line printer function to be performed. 
XRB+XRCI Channel number times two; defines the channel on which 


the line printer is currently open. 


XRB+XRBLKM Handler index for line printer: LPAHND (octal value 
equals 6). 
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(Line Printer) 
Data Returned (Line Counter Subfunction) 
XRB 
Mne- Octal Octal Mne- 


monic Offset Offset monic 


1 Uda 0 


3 | LSB of the 32- bit line counter | 2 XRBC 


7 Ueda 6 
a Vda 10 
13 Vda 12 
15 Vda 14 
XRB+XRBC The value of the 32-bit line counter. The LSB are 
returned in XRB+XRBC and the MSB are in XRB+XRBC+2. 
The counter is reset to zero when the line printer is 


opened. 


Data Passed (Line Position Subfunction) 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
+-------- mee eee ee ee eee teen en eee eee eee ee ee eee + 
1 | = 1 for sre position | O XRLEN 
per ee pe ee ee ee eee eee + 
3 Vdd 2 XRBC 
per ee epee ee ee ee eee + 
5 Vda 4 XRLOC 
i i ci a i i ii i ee + 
XRBLKM 7 ! LPAHND (= 6) i channel number * 2 | 6 XRCI 
a + 
ll WLLL 10 XRBLK 


13 WLLL 12 


15 WLLL 14 
XRB+XRLEN The special line printer function to be performed. 
XRB+XRCI Channel number times two; defines the channel on which 


the line printer is currently open. 
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(Line Printer) 


XRB+XRBLKM Handler index for line printer: LPAHND (octal value 
equals 6). 


Data Returned (Line Position Subfunction) 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
| i oi + 
1 UWaddadddddiddda 0 
Se + 
3 | curr horiz position H curr vert position | 2 XRBC 
Sl i Si + 
SISSSALIIIAIAAAIA IAAI AAAS AAA AAA AAA AAA AAA 171 \ A 
Si 5 + 
7 AGERE EEA RISER SR RGR NEMA LA EMRE RELEASE 6 
Se + 
11 SP LPPLPLILLILLTPTILLIPL APA TLLEPATST TPL TPTTDD 10 
Herr ee ee eee eee Sr (en eeee + 
V3 |SSSAAIIISIAI SI IIIAAIAI AAA ASIA AAA SAAS AS11471 V2 
Herr eee Sr + 
15 EOI EO ARLE A Gi IEMA L A Sa cea 14 
Se + 

XRB+XRBC The current vertical line position. The value is in 
the range 0 (top of page) to L-1l, where L is the page 
length. 

XRB+XRBC+1 The current horizontal line position. The value is in 
the range 0 (left margin) to W-1, where W is the page 
width. 

Errors (Line Printer) 

BSERR An illegal channel number is specified at XRB+XRCI. 

NOTOPN The channel specified at XRB+XRCI is not open. 

PRVIOL Privilege violation; one of the following conditions 


has occurred: 


o The calling job does not own the specified printer 
and does not have DEVICE privilege. 


o The function code is not 0 or l. 


o The device open on the channel specified at 
XRB+XRCI is not a line printer. 


3-228 


- SPEC 
(Magnetic Tape) 
-SPEC for Magnetic Tape 
Privileges Required 
None 


Data Passed (Magnetic Tape) 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tenn ree eee eee ee eee eee terre er ee re ee ee ee eee + 
ae = special function code | 0 XRLEN 
tenn rr eee ee eee ee eee Se + 
ol parameter | 2 XRBC 
terre eee eee ee ee ee eee tee ee ee ee eee ee eee + 
5 OEE UME OLE Melee eta ae el 4 
Se + 
XRBLKM 7 | MTAHND (=octal 16) ij channel number * 2 | 6 XRCI 
Se terre ee ee ee eee eee + 
LL VSSSASS LALA IIAA IIIA SAAS A AAAS AAAS S1A1 1177 \ 0 
5 Se + 
LS (SSSA SSSASAISIIAISIIAAAAI AAA AAAS SSSA SSS A2 
Se tee eee er ee eee ee ee eee + 
15 ee ee 14 
Se + 
XRB+XRLEN The special magnetic tape function to be performed (see 


Table 3-6). For a detailed discussion of these 
functions, see the discussion of the MAGTAPE function 
in the RSTS/E Programming Manual. 


XRB+XRBC The meaning of this word varies according to the 
special function code specified at XRB+XRLEN. Table 
3-6 summarizes these values; for a detailed discussion, 
see the MAGTAPE function description in the RSTS/E 
Programming Manual. 


XRB+XRCI Channel number times two; defines the channel on which 
the tape is currently open. 


XRB+XRBLKM Handler index for magnetic tape: MTAHND (octal value 
equals 16). 
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(Magnetic Tape) 


Table 3-6: Special Functions for Magnetic Tape 


tener Herre ee ee ee ee eee tere cee eee ee eee Se + 
| Code | Action | Parameter § | Value Returned | 
+------ tenn eee ee ee eee ee ee eee terre eee eee eee porn ee ee ee eee eee + 
| | | | | 
| O | Rewind and off-line | Unused bs of) | 
| | | | | 
| 1 | Write end-of-file | Unused | 0 | 
| | | | | 
| 2 | Rewind | Unused | O | 
| | | | 
| 3 | Skip record | # records to | # records not | 
| | | skip | skipped | 
| | | | | 
| 4 | Backspace over record | # records to | # records not | 
| | | backspace | backspaced | 
| | | | | 
| 5 | Set density and | D+P+S * | 0 | 
Oe hae 

| 
| 6 | Tape status function | Unused | (see Table 3-7) | 
| | | | | 
| 7 | File characteristics | Unused | (see Table 3-7) | 
| | | | | 
| 10 | Rewind on close | Unused | O | 
| | | | | 
| 11 | End of volume | Unused | 0 | 
| | | | | 
| 12 | Error condition | Unused | O | 
| | acknowledged | | | 
Bi ee ee ee eee eee + 
| * Parameter word for function code 5: | 
| | | 
| D = | Density | 
| | | 
| | 14 = 800. bpi | 
| | 400 = 1600. bpi, phase-encoded | 
| | | 
| P = | Parity (0 = odd, 1 = even) ** (800. bpi only) | 
| | | 
| S = | Stay | 
| | | 
| | 0 = MODE value specified in OPEN does not stay on CLOSE | 
| | 20000 = MODE value specified in OPEN is retained after | 
| | CLOSE | 
Hr ee ee eee ee ee ee ee eee + 
| ** DIGITAL recommends that you use odd parity. When you use even | 
| parity, you cannot write binary data. In addition, many | 
| operating systems and tape drives do not support even parity. | 
He ee ee ee ee ee ee eee eee + 
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Data Returned (Magnetic Tape) 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tere ree ee ee ee ee ee eee tree eee eee ee ee eee + 
LYSSSAAIIIASAIII AAA AAA AAA AAA AAA AAA AAA AAA \ 
terre ee eee ee eee eee eee terre eee re ee ee ee ee eee + 
3 (| value (see Table 3-7) | 2 XRBC 
terre reer ee ee ee ee eee tener ee tee eee ee ee eee + 
5 UA ARE LAE CEASA EEE TEI EEA A KERALA RRRASEM 4 
ed + 
7 WZ 6 
ie + 
11 UZ aadddddaadiada 10 
ee + 
13 Veda 12 
Se es + 
15 Vaal 14 
terre eee ee ee ee eee eee tener nee ee ee ee eee eee + 
XRB+XRBC The meaning of this word varies according to the value 


at XRB+XRLEN in the data passed. Table 3-7 summarizes 
these values. For a detailed discussion, see the 
MAGTAPE function description in the RSTS/E Programming 
Manual. 
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Table 3-7: Value Returned by .SPEC for Magnetic Tape 


Se i + 
| Octal | 
| Bit Value Meaning | 
Hen ee ee ee ee ee ee ee eee es + 
| Value Returned at XRB+XRBC for Function Code 6 (Magnetic Tape | 
| Status Word) | 
Hr ee ee ee ee ee ee ee eee eee, F 


15 100000 
14-13 If bit 
00000 
20000 
40000 
60000 
If bit 
00000 
20000 
40000 
60000 


12 00000 
10000 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

f Ay 0000 
| 4000 
| 

| 10 2000 
| 

| 9 1000 
| 

| 8 400 
| 

| 7 200 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 


6 100 


20 


10 


Last command caused an error. 

= 0, these bits indicate density: 
Reserved 

Reserved 

800. bpi 

Reserved 

= 1, these bits indicate density: 
1600. bpi 

Reserved 

Reserved 

Reserved 


9-track tape 
Reserved 


Odd parity 
Even parity 


Magnetic tape is physically write-locked 

Tape is beyond end-of-tape (EOT) marker 

Tape is at beginning-of-tape (BOT) 

Last command detected an end-of-file (EOF) 

The last command was .READ and the record read 
was longer than the I/O buffer size; that is, 
part of the record was lost 


Unit is nonselectable (off-line) 


Unit does not accept 1600. bpi 
Unit accepts 1600. bpi 


See values for bits 14-13 
See values for bits 14-13 
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Table 3-7: Value Returned by .SPEC for Magnetic Tape (Cont.) 


| Value Returned at XRB+XRBC for Function Code 6 (Magnetic Tape | 
| Status Word) (Cont. ) | 


| 
| 
| 
0 = Off-line | 
1 = Read | 
2 = Write | 
| 3 = Write EOF | 
4 = | 
5 = | 
6 = | 


Rewind 
Skip record 
Backspace record 


| Value Returned at XRB+XRBC for Function Code 7 (File | 
| Characteristics Word) | 


word = 0, DOS format or ANSI U (undefined) format 
word # 0, ANSI format, with bit meanings: 


| 

| 

| 

| 

| 15-14 40000 F (fixed-length) 

| 100000 D (variable-length) 

| 140000 S (spanned) * 

| 

| 13-12 00000 Carriage control embedded 'M’ 
| 
| 
| 
| 
| 
| 


10000 FORTRAN carriage control ‘A’ 
20000 Implied LF/CR before record ’ ’ 


11-0 --- For Format F, this value is the record length, in 
bytes. 
For Format D, this value is the maximum record 
length, in bytes. 
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~SPEC for Pseudo Keyboards 
For pseudo keyboards, the .SPEC function lets you: 


o Disable and enable echo at the controlled job’s keyboard 
(that is, the KB side of the pseudo keyboard). 


o Read a flag word that tells you whether echo is ON or OFF at 
the controlled job’s keyboard. 


o Determine the current exit status of the controlled job. 


A pseudo keyboard receives two kinds of output from a controlled job: 
Character echo, which is done by the RSTS/E monitor, and program 
output, which occurs when a program writes to the controlled job’s 
keyboard. The .SPEC function affects only character echo, not program 
output. 


Character echo is enabled by default. However, in some pseudo 
keyboard applications, it is more convenient to disable character 
echo. For example, in a pseudo keyboard application that uses both a 
terminal and a pseudo keyboard, you get character echo from the 
terminal. You also get character echo and program output from the 
pseudo keyboard. You can use this function to disable character echo 
at the pseudo keyboard. 


Privileges Required 
None 


Data Passed 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
teen ee ee ee eee ee ee ee eee terre ee ee ee ee ee ee ee eee + 
dl) special function code | QO XRLOC 
terete ee eee ee ee ee ee eee Herre eee ee eee ee ee eee + 
3 | ieee eas | 2 XRBC 
Se + 
5 Veda 4 
+ -—e ese eseeeween ewe eeseee= se wetke he we we ew wee wsewe eww eseweese sew ew we ow 
XRBLKM 7 | PKHND (= 20) I channel number * 2 i 6 XRCI 
Se is + 
ll A PPILLLLLATLL ALLL LILI TLLLAPTPTAPPAPD PTLD 10 
+---- ee ee ee ee ee ee ee eee Se + 
13 TELE MEE GGL AEE EAMES SAKA Salle 12 
i ae + 
15 A PLLPILPLELLALLATLLLPLIPPALPPAPPAAST ALP L TLD 14 
tee eee ee ee ee ee ee ee eee terre eee ee eee ee ee ee eee + 
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XRB+XRLOC 


XRB+XRBC 


XRB+XRCI 


XRB+XRBLKM 


Data Returned 


-SPEC 
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The special function codes; the possible values are: 


Code Meaning 
0) Enable/disable echo or read flag. 
1 Read exit status. 


The action to be performed for the special function 
code 0. If: 


Value Meaning 
0 Read the flag word 

255 Enable echo 
-l1 Disable echo 


Channel number times two; defines the channel on which 
the pseudo keyboard is open. 


Handler index for pseudo keyboard PKHND (octal value = 
20). 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terete eee eee eee eee eee teen ee ee ee ee ee ee eee + 
1 AAS ELLA AU IS AAMC AEA R EAE AAR EM 0 
2 + 
3 | flag word or exit status | 2 XRBC 
teeter eee ee eee eee eee tener eee eee ee ee eee ee eee + 


5 ET LI EA TLE | 4 
7 Ueeaaaaaaiadiadia 6 
11 Vdd 10 
13 Waa 12 
15 OO NG Rr, 14 
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XRB+XRBC For special function code 0: 


If bit 5 = 0 Keyboard echo is enabled. 
= 1 Keyboard echo is disabled. 


For special function code 1, the current exit status or 
the worst exit status for the job you are controlling. 
The current exit status value is returned in bits 0-2 
and the worst exit status value is returned in bits 
4-6. Both values have the following meanings: 


Warning 
Success 
Error 

Severe error 


mm DN e © 


Errors 


No errors are possible with the pseudo keyboard subfunction of .SPEC. 
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The .SPEC directive for terminals has two forms. The first form lets 
you perform several different functions, such as cancel CTRL/O, set 
modes for tape, echo, and ODT, and cancel type-ahead. The second form 
lets you set, read, and clear private delimiters. 


Privileges Required 


SEND to broadcast a message to a terminal. SYSIO to force a command 
to a terminal. 


Data Passed (Terminal - Except Private Delimiters) 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se Sel + 
1," special function code | O XRLEN 
Se St + 
3 |KB number or number of bytes to send/force | 2 XRBC 
i tere ee ree eee ee eee eee + 
5 | starting address of bytes to send/force | 4 XRLOC 
Se ten rere ee eee ee ee eee + 
XRBLKM 7 | TTYHND (octal 2) | channel number * 2 | 6 XRCI 
Se Hen ee ee ee eee eee eee + 
11 | KB number See = 5, 6, or 12) | 10 XRBLK 
Se + 
13 LLILILLILLILL ALAA ALLALALLALLALAILALADDAD 12 
Se Se + 
15 AEA A A BELLA ESAS LEAL EL Sis SM SE 14 
Se + 
XRB+XRLEN Defines a special function: 
Code Meaning 


Cancel CTRL/O (see the .TTRST directive) 

Set tape mode (see the .TTAPE directive) 

Enable echo and clear tape mode (see the .TTECH 
directive) 

3 Disable echo (see the .TTNCH directive) 

4 Set ODT mode (see the .TTDDT directive) 

5 Force to keyboard (SYSIO privilege required) 

6 Broadcast to keyboard (SEND privilege required) 
7 

2 


Nr © 


Cancel all type-ahead 
Read CTRL/C flag 


For XRB+XRLEN = 12, if the caller owns the terminal 


being checked, the CTRL/C flag is cleared after it is 
read. Otherwise, the flag is just read. 
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XRB+XRBC For XRB+XRLEN = 0, 1, 2, 3, 4, 7, or 12: 


When XRB+XRBC equals 0, these functions take place on 
the terminal currently open for this job. When 
XRB+XRBC does not equal 0, these functions take place 
on the keyboard number specified in XRB+XRBC. This 
keyboard must be assigned to but not opened by the 
calling job. 


For XRB+XRLEN = 5 or 6: 
XRB+XRBC is the number of bytes to send or force. 


XRB+XRLOC For XRB+XRLEN equal to 5 or 6, this word contains the 
starting address of the bytes to be sent or forced. 


XRB+XRCI Channel number times two; defines the channel for the 
terminal specified at XRB+XRBEC. 


XRB+XRBLKM Handler index for terminals; TTYHND (octal value = 2). 

XRB+XRBLK For XRB+XRLEN = 5, 6, or 12, this word contains the 
keyboard number to which the data is to be sent or 
forced. 


Data Returned (Terminal - Except Private Delimiters) 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herre ee ee ee eee eee tere ee ee ee eee eee + 
LVSSSAIAIASIAIS1S 11610770 | CTRL/C flag | 0 XRLEN 
Se Se + 
3. | number of bytes not sent | 2 XRBC 
Here rr re ee ee ee eee eee terre ee ee eee eee eee eee + 
5 UL ddddeddddeeacaaaadddddiiiia 4 
Se + 
7 Wedd 6 
Se + 
11 SP PLLLILISTLLILAILILLSLULTALALLALADDADAALTD 10 
porte eee eee eee ter rrr tee eee ee eee + 
13 ELAS A MME M EEL EGE SALES GRAM Gls 12 
Se + 
15 Vad 14 
Se ee + 
XRB+XRLEN A value of zero indicates the CTRL/C flag was not set. 


A value of 377 indicates the CTRL/C flag was set. This 
value is only meaningful when the data passed in 
XRB+XRLEN was 12. 
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XRB+XRBC Number of bytes that could not be sent (returned only 
when XRB+XRLEN in the data passed was six). 


Exrors (Terminal - Except Private Delimiter) 


SERR An illegal channel number is specified at XRB+XRCI. 
NOTOPN The channel specified at XRB+XRCI is not open. 
PRVIOL Privilege violation; one of the following conditions 


has occurred: 


o The calling job does not own the specified keyboard 
and does not have DEVICE privilege 


o The function code is not 0 to 7 or 11 (returned for 
all .SPEC calls for terminals) 


o An illegal terminal number at XRB+XRBLK 
o The device open on the channel at XRB+XRCI is not a 
terminal 

Private Delimiters 
A private delimiter is a character used as a delimiter within a 
program. You can define any printing or nonprinting character to be a 
private delimiter, for example: 

o A letter 

o A function key such as DELETE 

o A control character such as CTRL/Z 

o A standard delimiter such as LINE FEED 
A private delimiter is useful on a data entry terminal with a 
specialized keyboard. You can use a large or conveniently located key 
as the delimiter key. Private delimiters are also useful in keypad 
applications. 
You can declare one character as a private delimiter on any RSTS/E 
system. In addition, an installation option allows the use of 
multiple private delimiters (see the RSTS/E System Installation and 
Update Guide). If your system has this feature, you can declare up to 
256 private delimiters. 
Multiple private delimiters let you do special character processing 


without using single character I/O. For example, by combining escape 
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sequences with private delimiters, you can define your own function 
keys in keypad applications. 


The rest of this section: 
o Provides general information about private delimiters 


o Shows the XRB layouts for setting, reading, and clearing 
private delimiters 


o Lists all private delimiter masks 
Characteristics of Private Delimiters 


Declaring a character as a private delimiter with the .SPEC directive 
overrides the existing interpretation for the character. Thus, unlike 
a standard delimiter such as RETURN or LINE FEED, a private delimiter 
does not echo at the terminal. In addition, a special character no 
longer performs its normal function. For example, when the DELETE key 
is a private delimiter, it does not erase the last character typed. 


A private delimiter has basically the same characteristics as a 
standard delimiter. Like a standard delimiter, it: 


o Terminates a .READ on the terminal. 

o Cannot be deleted except by CTRL/X. The DELETE key and 
CTRL/U do not affect private delimiters in the type-ahead 
buffer. (CTRL/X cancels all type-ahead buffering.) 


o Causes the system to awaken a sleeping job when typed at a 
terminal that the job has open or assigned. 


Once set, a private delimiter remains in effect for a terminal until 
one of the following occurs: 


o The program clears it 


o The job releases the terminal by deassigning it or by closing 
the I/0 channel where the terminal is open 


o The job terminates 


In addition, the system clears private delimiters when a dial-up line 
gets hung up or the job controlling the terminal is killed. 


Private delimiters change the way characters are processed in binary 
mode (MODE 1). When a terminal is open in binary mode and no private 
delimiter is in use, the system terminates a read after every 
character. However, if one or more private delimiters are in use, the 
system terminates a read only when a private delimiter is typed. 
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The system processes private delimiters after processing CTRL/S and 
CTRL/Q (if the TTSYNC characteristic is set) and escape sequences (if 
the terminal is in escape sequence mode). This feature prevents a 
terminal from becoming permanently stalled, and it also lets you use 
private delimiters and escape sequences in the same program. 


The system processes private delimiters before all other characters, 
including control characters such as CTRL/C. Thus, when you use a 
standard delimiter character as a private delimiter, it does not echo 
on the terminal. 

Programming Hint 

By combining escape sequences with private delimiters, you can define 
your own function keys without using single character I/O. For 
example: 


1. Make sure the keypad is in the right mode for your 
application 


2. Define each function as the PFl key followed by a character 


3. Define each character as a private delimiter so it does not 
echo on the terminal 


For example, you might define PF1l + A as one function and PFl + M as 
another function. 


Data Passed (Terminal - Private Delimiters) 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre ree ee eee ee ee eee ter cre err te ee re eee ee + 
1 | = octal 11 for private delimiters | 0 XRLEN 
t-- eee ree eee eee ee ee eee terre ere ee eee eee eee + 
3 | O or byte count when XRB+XRMOD = 1 or 2 | =2 XRBC 
Se + 
5] 0 or address when XRB+XRMOD = 1 or 2 | 4 XRLOC 
Sa i + 
XRBLKM 7 | TTYHND (=octal 2) | channel number * 2 | 6 XRCI 
Heer ee ee ee eee ee Sli + 
11 | flag byte | KB number | 10 XRBLK 
tenn re ee ee eee eee eee terre ee er ee ee eee ee eee + 
13? +) must = 0 | 12 XRTIME 
a terre ree ee ee eee eee eee + 
15: || subfunction code = 0, 1l, or 2 | 14 XRMOD 
tener ee ee eee eee eee terre rr te ee eee eee + 
XRB+XRLEN Function code; set to octal 11 for private delimiter 


mask. 
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XRB+XRBC For XRB+XRMOD equals zero, this word must be set to 
zero. 


For XRB+XRMOD equals one (set private delimiter mask), 
this word is the byte count for the private delimiter 
bit mask. 


For XRB+XRMOD equals two (read private delimiter mask), 
this word is the buffer length for a buffer into which 
the mask is to be read. 


For XRB+XRMOD equals one or two, the value of XRB+XRBC 
must be less than or equal to 32. 


XRB+XRLOC For XRB+XRMOD equals zero, this word must be set to 
zero. 


For XRB+XRMOD equals one, this word is the address of 
the private delimiter mask. The mask itself can be up 
to 32 bytes long (32 bytes = 256 bits). Each bit in 
the mask represents an ASCII character (see Table 3-8). 
Setting a bit indicates that the associated ASCII 
character is to serve as a private delimiter. 


For XRB+XRMOD equals two, this word is the address of a 


buffer into which the terminal’s private delimiter mask 
is to be read. 


Table 3-8: Private Delimiter Masks 


+------- terete ee eee eee ee eee toe - ee ee eee t---- i + 
| | | | | Byte Value | 
+ | | | tere cece 5 + 
| Octal | ASCII | Byte, | | | | 
| Value | Character | addresstn | Bit | Octal | Decimal | 
+--+ eee tenn eee eee eee ee ee eee +----------- tener tee eee toe eee eee + 
| O* | NUL | n=0 | O | 1 | 1 | 
| | | | | | 
| 1 | SOH | 0 ae: Se 2 | 2 | 
| | | | | | 
| 2 | STX | 0 | 2 | 4 | 4 | 
| | | | | | | 
| 3 | ETX(CTRL/C) | 0 i Sr 4 10 | 8 | 
| | | | | | | 
| 4 | EOT | 0 | 4 | 20 | 16 | 
| | | | | | 
| 5 | ENQ | 0 | 5S | 40 | 32 | 
| | | | | | | 
| 6 | ACK | 0 | 6 | 100 | 64 | 
| | | | | | | 
| 7 | BEL | 0 oe 200 | 128 | 
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Private Delimiter Masks (Cont.) 


Table 3-8: 
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Private Delimiter Masks (Cont.) 


Table 3-8: 
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Private Delimiter Masks (Cont. ) 


Table 3-8: 
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Private Delimiter Masks (Cont. ) 


Table 3-8: 
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Private Delimiter Masks (Cont.). 


Table 3-8: 
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Table 3-8: Private Delimiter Masks (Cont.) 


+------- tenner ee ee ee ee ee ee +--- +--+ ---- +----- tee e eee eee eee eee + 
| | | | | Byte Value | 
+ | | | t------- t-- eee eee + 
| Octal | ASCII | Byte, | | | | 
| Value | Character | addresstn | Bit | Octal | Decimal | 
+------- Here ee ee eee ee eee eee t------ eee ee +----- tore cere +--------- + 
| | | | | | | 
| 166 |v | 16(14) | 6 | 100 | 64 | 
| | | | | | | 
| 167 |w | 16(14) | 7 | 200 | 128 | 
| | | | | | 
| 170 | x | 17(15) | O | de al 1 | 
| | | | | | 
| ivi ol[y | W7W(15) | 1 2 | 2 | 
| | | | | | | 
| 172 | 2 | E7CQS). i) <2 4 4 | 4 | 
| | | | | | | 
| 173 | { | 17(15) | 3 | 10 | 8 | 
| | | | | | 
| 174 | |(vertical) | 17(15) | 4 | 20 | 16 | 
| | | | | | | 
| 175 | } | 17CES)*- fF Se 4 40 | 32 | 
| | | | | | 
| 176 | ~(tilde) | 17(15) | 6 | 100 | 64 | 
| | | | | | | 
| 177  #+| DEL(RUBOUT) | L7(LS) |} JF | 200 | 128 | 
t------- teen er ee ee ee ee ee eee +----------- +----- +------- +--------- + 
200- Can only be used for terminals with the /EIGHT_BIT 


| | 
377 | characteristic set or open in binary mode; the 8th bit | 
| is cleared in normal mode for terminals with the | 
| /NOEIGHT BIT characteristic. | 
| * Octal code 0 can be used only for terminals opened in binary | 
| mode because nulls are ignored in normal mode. | 


XRB+XRCI Channel number times two. When this byte equals zero, 
it indicates the job’s keyboard. When this byte does 
not equal zero, a keyboard must be open on the 
indicated channel. 


XRB+XRBLKM Handler index for terminals; TTYHND (octal value is 2). 

XRB+XRBLK Specifies the keyboard number that the subfunction is 
to take place on. If this byte and the byte at XRB+1l 
equal zero, then the subfunction is performed on the 
terminal open on the channel indicated by XRB+XRCI. 


XRB+11 Flag byte. If bit 7 of this byte is set (byte equals 
128), it indicates that the keyboard number at 
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XRB+XRTIME 


XRB+XRMOD 


-SPEC 
(Terminal ) 


XRB+XRBLK is real. (When XRB+XRBLK is zero, this bit 
set indicates that KBO: is the desired terminal. If 
this bit is cleared and XRB+XRBLK is zero, it indicates 
that the keyboard open on the channel indicated at 
XRB+XRCI is the desired terminal.) All other bits must 
equal zero. 


This word must be set to zero. 


Subfunction code: 


0 = Clear private delimiter mask. 
l = Set private delimiter mask. 
2 = Read private delimiter mask. 


Once set, private delimiters remain in effect for a 
terminal until cleared (XRB+XRMOD = Q) or until 
implicitly cleared by: 


o Deassigning or closing the terminal 

o Killing the job or hanging up the line 

o Keyboard monitor read (negative wait time on .READ) 
Note that clearing the delimiter mask to all zeros is 
not the same as issuing the clear subfunction 


(XRB+XRMOD = 0). Use the clear subfunction to free 
system resources used when any mask is set. 


Data Returned (Terminal - Private Delimiters) 


Except for a possible error in byte 0 of the FIRQB, the private 
delimiter subfunctions of .SPEC do not return any meaningful data. 


Errors (Terminal - Private Delimiters) 


BADCNT 


BSERR 


ERRERR 


NOBUFS 


One of the following conditions has occurred: 


o Byte count at XRB+XRBC does not equal zero or is 
greater than 32 


o Invalid address at XRB+XRLOC 
An illegal channel number is specified at XRB+XRCI. 


Multiple delimiter feature is not included in the 
monitor. 


The monitor needs to expand its internal buffer space, 
but memory is not available; a retry may succeed. 
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NOSUCH You are trying to read the private delimiter mask, but 
no private delimiters are set. 

NOTOPN The channel specified at XRB+XRCI is not open. 

PRVIOL Privilege violation; one of the following conditions 


has occurred: 


o Job does not own the specified keyboard and does 
not have the required privilege 


o Subfunction code at XRB+XRMOD is not 0, 1, or 2 


o Function code is not 0 through 7 or 11 (returned 
for all .SPEC calls for terminals) 


o An illegal terminal number is specified at 
XRB+XRBLK 


o The device open on the channel specified at 
XRB+XRCI is not a terminal 
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-STAT ~ Return Job Statistics 
Form 
-STAT 


Function 


- STAT 


The .STAT directive returns current statistics on the job to the XRB. 


Privileges Required 


TUNE is required to read the current run priority or run burst 


settings. 


Data Passed 


The .STAT directive does not pass any meaningful data. 


Data Returned 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre eee ee ee ee eee eee perce rte ee ee eee + 
1 | current job image size, in K words | 0 XRLEN 
Sl Se + 
3 | current run-time system size, in K words | 2 XRBC 
Sl terre rr eee ee ee ee eee + 
5 | current private memory max, in K words | 4 XRLOC 
St Hone rrr ee ee ee eee eee + 
7: {| maximum job image size, in K words | 6 XRCI 
tener ee ee ee eee eee eee terre ee ee ee ee ee eee + 
11 | current PPN | 10 XRBLK 
terre re ee eee ee ee eee terre re ee ee eee eee + 
3:. current run priority | 12 XRTIME 
torr rr ee ee ee eee Herr ee ee ee eee + 
1S |) current run burst | 14 XRMOD 
tee ere ee ee eee eee eee tere rrr ee ee ee eee + 
XRB+XRLEN The current size of the user job image for this job, in 
K words. If I&D space is enabled, this is the size of 
only the D-space of the task. 
XRB+XRBC The size of the current run-time system for this job, 
in K words. 
XRB+XRLOC The current private memory maximum for the user job 


image, in K words 
maximum or if its 


. «If the job has an unlimited memory 
private memory maximum is larger than 


the possible maximum size allowed by its current 


run-time system, 


then the value returned here is the 
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maximum size possible for the current run-time system, 
in K words. If the job’s private maximum is less than 
the run-time system minimum, then the value returned 
here is the run-time system’s minimum size (see the 
-CORE directive). 


In all cases, this value represents the maximum size of 
the user job image under its current run-time system. 


XRB+XRCI The maximum job image size possible (under the current 
run-time system), in K words. If I&D space is enabled, 
this is the maximum size to which D-space can expand. 


XRB+XRBLK The job’s current PPN is returned here. The programmer 
number is returned as a binary value in the low byte 
(XRB+XRBLK), the project number as a binary value in 
the high byte (XRB+1l1). If the job is not logged in, a 
value of 0 is returned here. 


XRB+XRTIME The job’s current run priority (if caller has TUNE 
privilege; otherwise, .STAT returns zero). Run 
priority may range from -128, indicating a suspended 
job, to +127, the highest priority. The monitor 
schedules jobs for time-shared execution according to 
this priority. When a user first logs in to RSTS/E, 
LOGIN is run with priority 0. LOGIN sets the user’s 
job run priority to -8. Only in unusual cases should 
the run priority be changed. It can be changed by a 
user with TUNE privilege for any job with the SET 
JOB/PRIORITY command. It can also be changed with the 
UU.PRI subfunction of the .UUO directive. It can be 
modified by the job by one-half step (4) with the .SET 
and .CLEAR directives. 


The special-case value of -128 indicates that the job 
is never scheduled to run; it is suspended. 


XRB+XRMOD The job’s current run burst (if caller has TUNE 
privilege; otherwise, .STAT returns zero). The:run 
burst is the amount of time that the job is allowed to 
execute compute-bound before the next job in the 
schedule is given control. 


The units of run burst are 1/60ths or 1/50ths of a 
second, depending on the clock in use and/or the line 
frequency. (Systems running with the KW11-P clock at 
crystal speeds, rather than at line frequency, have a 
run burst unit of 1/50th of a second. Otherwise, if 
the system is operating with a 60 Hz power line, one 
run burst unit equals 1/60th of a second.) The range of 
values for run burst is from 1 to 127. 
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When a job is created, the monitor sets the run burst 
to a value of six. This value can be modified by the 
system manager for a particular job with the SET 
JOB/RUN_BURST command. It can also be modified with 
the UU.PRI subfunction of the .UUO directive. 


Errors 


No errors are possible on this directive. 


Example 


Since the .STAT directive does not pass any data to the monitor, the 
call is simply: 


- STAT 
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-TIME - Return Timing Information 
Form 
. TIME 
Function 
The .TIME directive returns job timing information: elapsed CPU time, 
elapsed time connected to a user terminal (channel 0), elapsed device 
time, and memory utilization. 
Privileges Required 
None. 
Data Passed 


The .TIME directive does not pass any meaningful data. 


Data Returned 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Sl Si + 
1 | low 16 bits of elapsed CPU time, .1 sec. | 0 XRLEN 
Se Se + 
3 | elapsed connect time to channel 0, min. | 2 XRBC 
Sr pec n ree ee eee ee eee + 
5 | low 16 bits of memory utilization, KCTs | 4 XRLOC 
Se terre eee ee ee eee + 
7 | elapsed device time, minutes | 6 XRCI 
tener ee eee eee eee Se + 
11 | high 16 bits of nas CPU time, .1 sec. | 10 XRBLK 
ee + 
13 Veda 12 
Se + 
15 | high 16 bits of a utilization, KCTs | 14 XRMOD 
terre eee eee eee Se + 
XRB+XRLEN The low-order 16 bits of the job’s elapsed CPU time, in 


tenths of a second of CPU utilization. 


XRB+XRBC The elapsed time that the job has been connected to a 
channel 0 terminal, in minutes. 


XRB+XRLOC The low-order 16 bits of the job’s memory utilization, 


in kilo-core-ticks (KCTs). A kilo-core-tick is the use 
of 1K of memory for one-tenth of a second. 
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XRB+XRCI The job’s elapsed device time. Device time is the use 
of an allocatable device for one minute. If a job owns 
two devices for one elapsed minute, then two units of 
device time are accrued. 


XRB+XRBLK The high-order 16 bits of the job’s elapsed CPU time 
(see XRB+XRLEN). 


XRB+XRMOD The high-order 16 bits of the job’s memory utilization 
(see XRB+XRLOC). 


Errors 

No errors are possible with the .TIME directive. 

Example 

Since the .TIME directive does not pass any data, the call is simply: 


- TIME 
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-TTAPE - Enter Tape Mode 
Form 

. TTAPE 
Function 
The .TTAPE directive enters tape mode on the job’s terminal (channel 
0). Use this directive when it is necessary to read data from the 
low-speed paper tape reader available on some terminals. Make sure 
the terminal is open on channel 0, and call this directive before the 


.READ directive. Three things happen: 


o No incoming characters are echoed, preventing needless output 
at the terminal while the tape is being read. 


o The DELETE character (ASCII code 177) is ignored, rather than 
deleting the previous character. 


o A LINE FEED character (ASCII code 012) is not automatically 
appended to an incoming RETURN (ASCII code 015). 


The .TTECH directive returns character processing to normal on channel 
0. 


Privileges Required 

None 

Data Passed 

The .TTAPE directive does not pass any data. 
Data Returned 


The .TTAPE directive does not return any data. 


Errors 

DETKEY Channel 0 is not currently available for this job; it 
is running detached. 

Example 


Since the .TTAPE directive does not pass or return any data, the call 
is simply: 


. TTAPE 
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',TTDDT - Disable Full-Line Buffering 
Form 

. TTDDT 
Function 


The .TTDDT directive disables the monitor’s usual practice of 
buffering a full line of data from the user’s terminal (channel 0) 
before passing it on to the job on a .READ directive. 


The monitor accepts data typed at a user terminal and stores it ina 
buffer until the job associated with the terminal reads the data. 
Normally, a .READ causes the monitor to pass a line to the job’s 
buffer. (A line is any number of characters ending with a RETURN, 
LINE FEED, ESCAPE, FORM FEED, or CTRL/D combination.) If a full line 
is not in the monitor’s buffer, the monitor stalls the job until it 
gets a delimiter and then awakens the job and passes the line on to 
the job’s buffer. 


The .TTDDT directive tells the monitor that, when the next .READ on 
the user’s terminal is issued, it is to pass on whatever is currently 
in the monitor’s buffer, whether or not a delimiter has been typed. 

If no characters are in the monitor’s buffer, the job is stalled until 
at least one character has been typed. 


-TTDDT is a one-shot directive: it affects only the next .READ on the 
user’s terminal. If you want to do this type of input consistently, 
you must execute a .TTDDT before each .READ. 


This type of input is useful when you want to respond to each 
character that a user types. (Note that more than one character may 
be in the monitor’s buffer. If you really want only one character, 
use .TTDDT before each .READ, and define a l-character input buffer 
for the .READ.) For example, the ODT utility (see the ODT Reference 
Manual) uses this capability to accept commands without requiring that 
you type a delimiter. This type of input puts a high load on the 
system; DIGITAL does not recommend its use except in unusual 
circumstances. 

Privileges Required 

None 

Data Passed 

The .TTDDT directive does not pass any data. 

Data Returned 


The .TTDDT directive does not return any data. 
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Errors 

DETKEY Channel 0 is not currently available for this job; the 
job is running detached. 

Example 


Since the .TTDDT directive does not pass any data, the call is simply: 


. TTDDT 
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-TTECH -- Undo .TTAPE or .TTNCH 
Form 
. TTECH 
Function 
The .TTECH directive causes the monitor to resume normal character 
input processing on channel 0 when it has been disabled with either a 
-TTAPE directive or a .TTNCH directive. 
Privileges Required 
None 
Data Passed 
The .TTECH directive does not pass any data. 


Data Returned 


The .TTECH directive does not return any data. 


Errors 

DETKEY Channel 0 is not available for this job; the job is 
running detached. 

Example 


Since the .TTECH directive does not pass any data, this call is 
simply: 


. TTECH 
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-TTNCH -- Stop Echo 
Form 

. TTNCH 
Function 
The .TTNCH directive disables terminal echo on the job’s terminal 
(channel 0). That is, whatever the user types is accepted, but it is 
not echoed back for display on the terminal. Otherwise, all normal 
character processing occurs. (The .TTECH directive returns character 
processing to normal on channel 0.) 
Privileges Required 
None 
Data Passed 
The .TTNCH directive does not pass any data. 


Data Returned 


The .TTNCH directive does not return any data. 


Errors 

DETKEY Channel 0 is not available for this job; the job is 
running detached. 

Example 


Since the .TTNCH directive does not pass any data, the call is simply: 


. TTNCH 
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-TTRST - Restart Output 
Form 

~TTRST 
Function 
The .TTRST directive restarts program output to the user’s terminal 
when such output has been stopped by the user’s typing a CTRL/O or 
CTRL/C. 
Terminal service in the RSTS/E monitor maintains a "discard all 
program output" indicator for each terminal. When this indicator is 
set, the driver ignores a .WRITE directive to the terminal rather than 
display the data at the user’s terminal. When the indicator is clear, 
a .WRITE to the terminal is processed normally. The .TTRST directive 
clears this indicator. 
The driver sets the indicator when the user enters a CTRL/C 
combination. It reverses the indicator when the user enters a CTRL/O 
combination. A .READ directive to the user’s terminal clears the 
indicator. 
One use of .TTRST is in run-time systems with keyboard monitors. By 
issuing .TTRST before displaying any prompt, you can ensure that the 
prompt is actually displayed at the user’s terminal. 
Privileges Required 
None 
Data Passed 
The .TTRST directive does not pass any data. 


Data Returned 


The .TTRST directive does not return any data. 


Errors 

DETKEY The user’s terminal is not currently available for this 
job; the job is running detached. 

Example 


Since the .TTRST directive does not pass any data, the call is simply: 


-TTRST 
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~-ULOG - Allocate/Reallocate/Deallocate Device or Assign/Deassign User 
Logical 


Form 
. ULOG 
Function 
The .ULOG directive has three subfunctions. You select the particular 
action desired by setting a function field in the FIRQB (at offset 


FQFUN). Table 3-9 lists the subfunctions by function code. The 
following sections describe the subfunctions in alphabetical order. 


Table 3-9: Summary of .ULOG Subfunctions 


tect eee ee tee - eee ee ten ne ee ee ee ee ee ee ee ee ee ee ee eee + 

| FQFUN | | | 

| Value | | | 

| (Octal) | Mnemonic | Action Performed | 

terete eee teen eee eee Herre ee ee ee ee ee ee ee eee ee ee eee + 
12 UU.ASS Allocate/reallocate a device or assign 


user logical 


| 
| 
| 
| 
Deallocate a device or deassign a user | 
| 
| 
| 
| 


13 UU.DEA 
logical 
14 i; UU.DAL Deallocate all devices and deassign all 
| user logicals 
+-- eee ee t-- cc eee ee Hn ne ee ee ee eee + 


Privileges Required 


See the descriptions of each .ULOG subfunction. 
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UU.ASS (Allocate/Reallocate a Device, or Assign User Logical) 


Form 


MOVB #UU.ASS,FIRQB+FQFUN 


e 


(set up FIRQB and XRB) 


-ULOG 
Function 
The UU.ASS subfunction of .ULOG lets you do one of three things: 
o Allocate a device to a job. 
o Reallocate a device to another job. 
o Enter a user logical. This feature lets you: 


- Assign a logical name to a device. The monitor then uses 
this assignment for logical-to-physical device 
translation by the .FSS directive. 


- Associate a PPN with a particular logical name. This 
user logical PPN is used if the associated logical name 
(but no PPN) is found in a string scanned by .FSS. Use 
this feature if you want to override a system-wide 
logical name with an associated PPN. For example, the 
logical name LB is commonly associated with a disk on the 
public structure and some specific PPN (usually [1,1]). 
With this feature, you can set up a different device and 
PPN for the iogical name LB. 


- Assign a PPN to be substituted for an at sign (@) 
character encountered ina file specification string 
scanned by an .FSS directive. 

- Assign a protection code to be used as a default if no 


protection code is specified in a file specification 
string translated by an .FSS directive. 


Note 


Assigning user logicals assigns values to the USRPPN, 
USRPRT, and USRLOG areas in the low 1000 bytes of 
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virtual memory (see Chapter 2). If these values are 
in a nonstandard location, you must specify where they 
are by setting the XRB. For all other uses of .ULOG, 
the XRB should be cleared to zeros. 


Privileges Required 

No privileges are required to manipulate user logicals or deallocate a 
device. DEVICE is required to allocate a restricted device. HWCTL is 
required to seize a device or reallocate a device to a job in another 

account. 


Data Passed - Allocate/Reallocate Device 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tere ee ee ee ee eee eee tern re ee ee ee ee ee eee + 
1 EERE EMMA GALA A SOLA ALAN hl AAR ik hehe 0 
Se i + 
FQFUN 3 | UU.ASS (= octal 12) | 2 
i ie + 
5 PLIPLILLPALLT ALT LPLLPPLALTAPA TSI AADI LAP AD 4 
tere ee ee ee ee ee ee eee eee Herre re ee eee eee + 
7 | (must be 0) | 6 FQPPN 
te -- eee eee ee eee eee eee teen ee ee ee ee eee ee ee eee + 
11 | (must be 0) : O=assign; #0=job | 10 FQNAM1 
Se i + 
13  PLILILLITLLALILY ALLL LL APEDLAPLAPDTPPA DID 12 
tener ee ree ee ee eee eee tere ree ne ee ee ee ee ee eee + 
15 | DOS or ANS in RAD50 format (1 word) | 14 FQEXT 
ter creer ee ee eee eee eee tec er ee te ee ee eee eee + 
17 LEE AONE RESALE ELENA SEEMED ELLE 16 
Se + 
21 EEE. 20 
Se tere re ee er et ee ee ee eee + 
23 | 100001 for aut else 0 | 22 FQMODE 
Se + 
25 WZ 24 
27 H (must oe 0) i 26 FQPFLG 
So terre ee eee ee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
Herre ee ee ee ee ee ee eee teen ee eee ee ee eee ee eee + 
33 | #0, unit no. real | device unit number | 32 FQDEVN 
Se per ere re ee ee eee ee eee + 
35 I | 34 
i. a i imi + 
37 WLLL 36 
Si i + 
FIRQB+FQFUN The function code UU.ASS (octal value = 12). 
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) FIRQB+FOQNAM1 


FIROB+FQEXT 


FIT ROB+FQMODE 


FIRQB+FQDEV 


FIRQB+FQDEVN 


- ULOG 
UU.ASS 


For allocating a device, the two bytes beginning here 
must equal zero. 


For reallocating a device, this byte is the job number 
to which the device is to be reallocated. The byte at 
FIRQB+FOQNAM1+1 must equal zero. If you do not have 
HWCTL privilege, you can reallocate a device only to a 
job that is logged in to the same account as your 
current account. 


For allocating or reallocating a magnetic tape device, 
this word is either DOS or ANS (in RAD50 format) to 
indicate DOS or ANSI label format for the magnetic tape 
drive. 


For allocating or reallocating a device, setting this 
field to 100001 octal indicates a "seize" operation. 
That is, it allocates or reallocates the device even if 
it is currently allocated to another job. This feature 
can be issued by a caller with HWCTL privilege. 
Furthermore, the target device must not be open, and 
the current owner cannot be performing a directory 
lookup on that device with the UU.DIR subfunction of 
the .UUO directive. If you do not want a seize 
operation, set this word to zero. 


Device name to be allocated or reallocated, specified 
as two ASCII characters. If this word is zero, the 
public disk structure is assumed. 


Device unit number, passed as a binary value in byte 
FIRQB+FQDEVN. A nonzero value in byte FIRQB+FQDEVN+1 
indicates an explicit device unit number. A zero value 
in byte FIRQB+FQDEVN+1 indicates no device unit number. 


Note 


The XRB should be cleared to zeros for an allocate or 
reallocate device operation. 
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- ULOG 
UU.ASS 


Data Passed = 


Mne- Octal 


monic Offset 


Enter User Logical 


FIRQB 
Octal Mne- 
Offset monic 


1 LY LPLPILILI LL ILILI DAIL T LADD UL TLTLT IL ILTEDID 0 
FQFUN 3 | UU.ASS (= octal 12) OC ae. 2 


5 Veda 4 


project number H programmer number | 6 FQPPN 


| 10 FQNAML 


+ user logical device name in RAD50 format + 


FQPROT 27 | 


(2 words) | 12 


protection code {|255#assign prot. code| 26 FQPFLG 
wre er ee ee ee ee eee Sr | 

device name (2 ASCII characters) | 30 FQDEV 
eweeraeeneeweenee he ese eweweseewe SS peta 

#0, unit no. real | device unit number | 32 FQDEVN 
we ee ee ee ee eee eee re 


ST VSASSSSSISIIS IIASA ISSA AAAS AAAI SAAS SSS S117 \ 36 


FIRQB+FQFUN 


FIRQOB+FQPPN 


The function code UU.ASS (octal value = 12). 


The PPN for those features that use a PPN (see the 
discussion under Function at the beginning of this 
section). For a user-assignable PPN, this is the PPN 
to be used to replace an @ sign in a string parsed by 
an .FSS directive. In this case, the two bytes at 
FIRQB+FQNAM1 and FIRQB+FQNAM1+1 must be zero. 


If the four bytes FIRQB+FQNAM] through FIRQB+FQNAM1+3 
contain a logical device name, and a PPN is to be 
associated with that name, specify the PPN here. If no 
PPN is to be associated with the logical device name, 
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FIRQB+FQNAM1 


FIRQB+FQPFLG 


FIRQB+FQPROT 


FIRQB+FQDEV 


FIRQOB+FQODEVN 


Mne- Octal 
monic Offset 


1 | 
3 | 


5 | 


-ULOG 
UU.ASS 


set this word to zero. 


To assign a user logical name to a device, set the two 
words beginning here to the logical name, in RAD50 
format. Otherwise, set these bytes to zero. 


To assign a user-assignable default protection code, 
set this byte to nonzero. (See FIRQB+FQPROT. ) 


The protection code to be used as a default if no 
protection code is specified in a string scanned by an 
-FSS directive. The byte at FIRQB+FQPFLG must be 
nonzero, and the two words at FIRQB+FQPPN and 
FIRQB+FQNAM1 must be zero. 


Device name for assigning a logical name to be 
associated with a device. Specify the device as two 
ASCII characters. If this word is zero, the public 
disk structure is assumed. 


Device unit number for assigning a logical name to be 
associated with a device. The device unit number is 
passed as a binary value in byte FIRQB+FQDEVN. A 
nonzero value in byte FIRQB+FQDEVN+1 indicates an 
explicit device unit number. A zero value in byte 
FIRQB+FQDEVN+1 indicates no device unit number. 


XRB 
Octal Mne- 
Offset monic 
wee eee eee eee eee Se 2 
length of user logical information {| Q XRLEN 
were ee ee ee ee eee Se 2 
length of user logical information | 2 XRBC 
wee ee ee ee ee ee eee [ee } 
Starting address for user logical info. | 4 XRLOC 
| ee 


7 FA ele AAA KE AEA adits tate 6 
11 Vad 10 


13 Ud 12 


XRB+XRLEN 


eons ewe we eer ee ew ew ee Pe ew we es eee we wee ee ee eee ee ew ee Fe ew Pe Pe 


If the user logical information is in its standard 
location (USRPPN, USRPRT, and USRLOG), this word is 
passed as zero. If some nonstandard set of locations 
is being used, then specify the length of that 
information, in bytes, here. Thus, when the user 
logical information is in a nonstandard location, this 
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- ULOG 
UU.ASS 


XRB+XRBC 


XRB+XRLOC 


Data Returned 
FIRQB 


FIRQB+FQFIL 


Errors 


BADCNT 


BDNERR 


INUSE 


word must be at least four (for user-assignable PPN and 
Gefault protection code). The space for user logical 
names is optional. If no space is reserved for logical 
names in the nonstandard location, no such assignments 
are allowed. 


The length of the information (same as the word at 
XRB+XRLEN). 


If the word at XRB+XRLEN is nonzero, then this word 
defines the starting location for the user logical 
information (the default PPN). You must specify an 
even value. See Chapter 2 for a description of the 
order and format of the information created by .ULOG. 


The error code (if any). 


The previous owner of the device as follows: 
o If you own a device already and allocate it, UU.ASS 
returns your own job number. 


o If you seize a device, you can see who you seized 
it from. 


o If the value in FIRQB+FQFIL is zero, then you know 
that the device was not previously owned. 


This error has two possible causes: 


o The length specified at XRB+XRLEN and XRB+XRBC must 
be 4 + 8n, where n = 0, 1, 2, 3, or 4. If it is 
not, this error is returned. (Other lengths are 
not valid user logicals.) 


o The value at XRB+XRLOC is odd. 


An attempt was made to reallocate a device toa 
nonexistent job. This error can occur only for a 
reallocate call. 


For allocating or reallocating a device, the specified 
device is currently open or has an open file. For 
assigning a user logical, no space is currently 
available for storing the information. 
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-ULOG 


UU.ASS 
NODEVC The device name specified at FIRQB+FQDEVN is a logical 
device name for which a physical device is not 
currently allocated. 
NOTAVL The device specified exists on the system, but the 


operation failed for one of the following reasons: 


o The device is currently reserved by another job 
(see description of FIRQB+FQMODE). 


o Ownership of the device requires DEVICE privilege, 
which the user does not have. 


o The device or its controller is disabled. 


o The device is a keyboard line for a pseudo keyboard 
only. 


PRVIOL You do not have the required privileges and tried to 
reallocate a device to a job that is logged in to an 
account other than your current account. 


Example 


The following code allocates the user logical name OUT to the public 
disk structure. Assume that the FIRQB and XRB have been previously 
cleared to zero. For example: 


MOVB #UU.ASS, FIRQOB+FQFUN > Set function code 
MOV #° ROUT, FIRQB+FQNAM1 ; Set logical name as 
MOV #° R ,FIRQB+FQNAM1+2 : two words RAD50 
-ULOG 
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-ULOG 
UU.DAL 


UU.DAL - Deallocate All Devices and Deassign User Logicals 
Form 


MOVB #UU. DAL, FIRQB+FQFUN 


(set up FIRQB and XRB) 


- ULOG 
Function 


The UU.DAL function of .ULOG deallocates all devices and deassigns 
user logicals for the calling program. 


Privileges Required 


None 
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Data Passed 


Mne- Octal 


monic Offset 


1 


FQFUN 3 


37 


FI RQB+FQFUN 


Octal 


| UU.DAL (=octal 14) WLLL 


S275 


36 


Mne- 
Offset monic 


The function code UU.DAL (octal value equals 14). 


-ULOG 
UU.DAL 


- ULOG 


UU.DAL 
XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
ter tree ee ee eee ee eee Her ree ee ee ee eee eee + 
Li length of user logical information | O XRLEN 
SS Here eee ee eee eee eee + 
ce length of user logical information | 2 XRBC 
Herre ee eee eee eee terre ee eee ee ee ee eee eee + 
5 | starting address ee user logical info. | 4 XRLOC 
Se + 
7 WLLL 6 
eer ere weweemeeenenewse eee ewer ee ws ew ee ee eww ee hw hl hl hl hl hl le + 
1i WLLL 10 
ee + 
13  PLPILLISTILILPALLTPP PPL APLALA EL ALALTAD TE 12 
Se terre ee eee ee eee ee eee + 
15 TAREE MEER AH OEMS CASA AA EMMA AA A Cilla 14 
Se + 
XRB+XRLEN If the user logical information is in its standard 
location (USRPPN, USRPRT, and USRLOG), set this word to 
zero. If some nonstandard set of locations is being 
used, then specify the length (in bytes) of that 
information. 
XRB+XRBC The length of the information (same as the word at 
XRB+XRLEN). 
XRB+XRLOC If the word at XRB+XRLEN is nonzero, then this word 
defines the starting location for the user logical 
information (the default PPN). See Chapter 2 for a 


description of the order and format of the information 
created by .ULOG. 


Data Returned 
The UU.DAL subfunction of .ULOG does not return any meaningful data. 
Errors 
BADCNT This error has two possible causes: 
o The length specified at XRB+XRLEN and XRB+XRBC must 
be 4+8n, where n = 0, l, 2, 3, or 4. If it is not, 
this error is returned. (Other lengths are not 


valid user logicals.) 


o The value at XRB+XRLOC is odd. 
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- ULOG 
UU .DAL 


Example 


The following code deallocates all devices and deassigns user logicals 
for the current job. The user logical information is in its standard 
location. For example: 


MOVB #UU.DAL, FIRQB+FQFUN 
CLR XRB+XRLEN 

CLR XRB+XRBC 

CLR XRB+XRLOC 

-ULOG 
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-ULOG 
UU.DEA 
UU.DEA ~- Deallocate a Device or Deassign a User Logical 
Form 
MOVB #UU .DEA, FIRQB+FQFUN 


(set up FIROQB) 


- ULOG 
Function 
The UU.DEA subfunction of .ULOG deallocates a device from the current 
job (releases it for use by other jobs) or deassigns a user-logical 
assignment. 


Privileges Required 


None 
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-ULOG 


UU.DEA 
Data Passed for Deallocate Device 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Hee nee eee ee ee eee ee eee terete eee ee ee ee ee eee + 
LYSAIASIIIIIAI IAAI AAAI AAA AAA AAA AAAS AA 11747474 \ 2% 
tere eee ee eee eee eee eee terre ee ee eee ee ee eee eee + 
FQFUN 3 | UU.DEA (=octal 13) |SVSSS/SA/SA/IS/S/1/1////\ 2 
Here eee ee ee ee eee eee teen eee ee ee ee ee ee eee + 
5 CAO RR LEAL UEC E SIA SLE MAMA AARNE Meee 4 
Se eas + 
a A unias "he 0) | 6 FQPPN 
tere eee ee ee ee eee ee eee terre ee eee ee ee ee eee eee + 
11 | (muse be 0) | 10 FQNAM1 
tere n ee ee ee eee ee ee eee tere ee eee ee ee eee ee eee + 
L3 (SSAAIISIIIIAIIAI AAAI AAA AAA AAA AAA AAA AAA AAA A2 
Se terre ee ee eee ee ee ee eee + 
LS VSIAIIIIATIAAA SSAA AAAS AAA AAAS AAA AAA AAAS AAA \ 4X4 
tere eee eee re ee ee eee eee Se + 
17 COENEN GILDA MER EAN ARA DEL CCMA AEA CANE KL 16 
tenn ee ee ee be ee ee ee ee ee ee eee + 
21  PLPLTEPLYAISSPITSS PPL PPATSSP TSS POPPS PLD Y 20 
a tee eee ee ee ee ee ee ee eee + 
22 SSAA AAA AAA AAA AA AAA AAA AAAS AAA | 22 
tec ee ee eee eee ee ee ee eee tee - ee ee ee ee ee ee eee eee + 
25 OE 24 
Se i i on + 
27 | (must ae 0) | 26 FQPFLG 
tere eee eee ee ee eee ee eee tener ee ee ee ee ee ee eee + 
31. | device name (2 ASCII characters) | 30 FQDEV 
tere eee ee eee ee ee ee ee ee terre eee ee ee ee ee ee eee + 
33 ‘#0, unit number real | device unit number | 32 FQDEVN 
terre ee ee ree ee eee ee eee terre ee ee ee ee ee ee eee + 
35 A 34 
i os + 
37 Veaadadadadiadiiida 36 
he ee pe ee ee ee ee ee eee + 
FIRQB+FQFUN The UU.DEA function code (octal value equals 13). 
FIRQB+FQDEV The name of the device to be deallocated; two ASCII 


characters. 


FIRQB+FQDEVN The device unit number is passed in this byte, in 
binary. A nonzero value in FIRQB+FQDEVN+1 indicates an 
explicit device unit number. A zero value in 
FIRQB+FQDEVN+1 indicates no device unit number. 
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-ULOG 
UU.DEA 
Note 


The XRB should be cleared to zeros for deallocating a 
device. 


Data Passed for Deassign User Logical 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
i ee + 
1 Vdd 0 
in ee + 
FQFUN 3 | UU.DEA (=octal 13) WL 2 
Se Herre er ee eee eee eee + 
5 CELA ABA LA ERAS LCL Ik CARE MALES SSG 4 
Se iis + 
7 | #0, deassign aefeaie ppn; else must be 0 | 6 FQPPN 
Se tee ee eee ee ee eee eee + 
11 | | 10 FQNAM1 
+ user logical device name in RAD50 format + 
iS |] (2 eae me & 


17 VSLILILILILILIDILILILTLILILILID IL IL ITED IDLY 16 


Horr eter eee eee ee ee eee Here eee eee eee eee + 


21 UO 20 


27 IILILILILILILILT IT INA®, deass def prot cde| 26 FQPFLG 


Herc n rere ee ee eens torre ee ee eee eee eee + 


31 CESARE EASE EE ALE MEDAL AKANE MAGE, 30 


FIRQB+FQFUN The UU.DEA function code (octal value equals 13). 


FIRQB+FQPPN Any nonzero value deassigns any previously assigned 
default PPN. (In this case, set the word at 
FIRQB+FQNAM1] to zero.) If deassigning the default 
protection code, set this word to zero. 
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FIRQB+FQNAM1 


FIRQB+FQPFLG 


Mne- Octal 
monic Offset 


1 | 
3 | 


5 | 


- ULOG 
UU.DEA 


The logical device name to be deassigned; two words in 
RAD50O format. If deassigning a default PPN or 
protection code, set the word at FIRQB+FQNAM1 to zero. 


Set this byte to nonzero if deassigning a protection 
code. 


XRB 
Octal Mne- 
Offset monic 
wee ee ee ee ee eee Se. 
length of user logical information | 0 XRLEN 
wee ee eee 5 ill rr: 
length of user logical information | 2 XRBC 
weer te eee ee eee 5 re. 
starting address for user logical info. | 4 XRLOC 
wre te ee eee ee ee i . 


Un VAAL hhh 
11 UALR LE SEE RESCUES MALLE ESA EM AERA ALS 10 
13 Vda 12 
15 LPLPILILILILLUL ILIA LLL IL TLT LAUD TL ITAL 14 


XRB+XRLEN 


XRB+XRBC 


XRB+XRLOC 


Data Returned 


If the user logical information is in its standard 
location (USRPPN, USRPRT, and USRLOG), this word is 
passed as zero. If some nonstandard set of locations 
is being used, then specify the length (in bytes) of 
that information. 


The length of the information (Same as the word at 
XRB+XRLEN). 


If the word at XRB+XRLEN is nonzero, then this word 
defines the starting location for the user logical 
information (the default PPN). See Chapter 2 for a 
description of the order and format of the information 
created by .ULOG. 


Except for a possible error in byte 0 of the FIRQB, the UU.DEA 


subfunction of 


.ULOG does not return any meaningful data. 
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- ULOG 
UU.DEA 


Errors 


BADCNT 


NODEVC 


Example 


This error has two possible causes: 


o The length specified at XRB+XRLEN and XRB+XRBC must 


be 4+8n, where n = 
this error is returned. 
valid user logicals.) 


1, 2, 3, or 4. If it is not, 


(Other lengths are not 


o The value at XRB+XRLOC is odd. 


The device or its type specified at the locations 
FIRQB+FQDEV and FIRQB+FQDEVN is not part of your system 


configuration. 


The following code deallocates MTO: from the current job: 


MOVB 
CLR 
MOV 
MOVB 
MOVB 
- ULOG 


#UU. DEA, FIRQB+FQFUN 
FIRQB+FQNAM1 
#"MT,FIRQB+FQDEV 
#0,FIRQB+FQDEVN 
#377, F IRQB+FQDEVN+1 
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=e %e NO WO WO 


Set function code 
Clear name 

Set device 

Set unit number 
Unit number real 


-UU0 


-UUO ~- Execute BASIC:PLUS SYS Call 
Form 

- UUO 
Function 


The .UUO directive lets a MACRO program execute the BASIC-PLUS SYS 
calls to the File Processor (FIP). The RSTS/E Programming Manual 
describes the SYS calls. For the MACRO programmer’s convenience, the 
FIRQB formats for the calls are shown here; however, for detailed 
descriptions see the RSTS/E Programming Manual. 


Table 3-10 summarizes the FIP SYS calls; note that some of the calls 
are handled by directives other than .UUO. (.FSS, for example, 
handles the file name string scan in MACRO.) The mnemonic subfunction 
names are provided by the COMMON.MAC prefix file; the decimal values 
are the BASIC-PLUS FIP call subfunction codes and the .UUO subfunction 
codes that COMMON.MAC relates to the mnemonics listed. 


The rest of this section gives the FIRQB formats for data passed and 


returned for the .UUO subfunctions; the subfunctions are organized in 
alphabetical order of the mnemonics provided by COMMON.MAC. 


Table 3-10: .UUO Subfunctions - Calls to the File Processor (FIP) 


None 


tee ore eee ee eee torre ete eee ee +------ ee eee Sl + 
| | BASIC-PLUS | | | 
| | SYS Call | | | 
| | Code | Privileges | | 
| Mnemonic | (Decimal) | That Apply | Function | 
te -- eee eee eee ee: Hee eee ee ee eee +o -- eee eee eee Se + 
| | | | 

| UU.TB3 | -29 | None | Get monitor tables -- 

| | | | Part III 

| | | | 

| UU.SPL | -28 | r/w file | Spooling 

| | | | 

| UU.DMP | -27 | SYSIO | Snap shot dump 
| | | | | 
| UU.FIL | - 26 | DATES,TUNE | File placement and 
| | | SYSIO,r/w | modification | 
| | | | | 
| UU.ATR | -25 | r/w acct | Read or write attributes | 
| | | | | 
| UU.CCL | -24 | INSTAL | Add/delete CCL command 
| | | | | 
| (.FSS) | -23 | | Terminating file name | 
| | | | | 


string scan 
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-UU0 


Table 3-10: .UUO Subfunctions ~- Calls to the File Processor (FIP) 


(Cont. ) 
tere e eee eee eee tere ee eee eee te -- eee ee eee Herne re ee ee ee ee ee eee eee 
| | BASIC-PLUS | | 
| | $YS Call | | 
| | Code | Privileges | 
| Mnemonic | (Decimal) | That Apply | Function 
+---- ee eee eee terete eee ee eee tee eee eee eee Herr ee ee ee ee ee eee 
| | | | 
| (.SET) | -22 | TUNE | Set special run priority 
| | | | 
| (.SET/ | -21 | None | Drop/regain temporary 
| CLEAR) | | | privilege 
| | | | 
| (.SET/ | -20 | TUNE | Lock/unlock job in memory 
| .CLEAR) | | | 
| | | | 
| UU.LOG | -19 | SWCTL | Set number of logins 
| | | | 
| UU.RTS | -18 | read file | Install run-time system 
| | | INSTAL | 
| | | | 
| | | INSTAL | Load, remove, or unload 
| | | | run-time system 
| | | | 
| | | INSTAL | Declare default keyboard 
| | | | monitor 
| | | | 
| | | read file | Install resident library 
| | | INSTAL | 
| | | | 
| | | INSTAL | Load, remove, or unload 
| | | | resident library 
| | | | 
| UU.NAM | -17 | write file | Name run-time system 
| | | | 
| UU.DIE | -16 | SHUTUP | System shutdown 
| | | | 
| UU.ACT | -15 | write acct | Accounting dump 
| | | 
| UU.DAT | -14 | DATES | Change system date/time 
| | | | 
| UU.PRI | -13 | TUNE | Change priority/run 
| | | | burst/job size 
| | | | 
| UU.TB2 | -12 | None | Get monitor tables -- 
| | | | Part II 
| | | | 
| UU.BCK | -11 | DATES | Change file backup 
| | | 
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statistics 


-UU0 


Table 3-10: .UUO Subfunctions - Calls to the File Processor (FIP) 


(Cont. ) 
teeter eee eee eee +---- ee eee eee te -- ee eee eee Henne ee ee eee ee ee eee eee + 
| | BASIC-PLUS | | | 
| | SYS Call | | | 
| | Code | Privileges | | 
| Mnemonic | (Decimal) | That Apply | Function | 
terre ee ee ee eee toe - eee eee eee +------+---- ee i + 
| | | | | 
| (.FSS) | -10 | None | File name string scan | 
| | | | 
| UU.HNG -9 | HWCTL | Hangup a dataset | 
| | | | | 
| UU.FCB -8 | None | Get open channel | 
| | | | statistics | 
| | | | | 
| (internal to | -7 | None | CTRL/C trap enable | 
| BASIC-PLUS) | | | 
| | | | | 
| UU.POK -6 | SYSMOD | Poke memory | 
| | | | 
| (.SPEC) -5 | SEND | Broadcast to terminal | 
| | | | | 
| (.SPEC) | -4 | SYSIO | Force input to terminal | 
| | | 
| UU.TB1 | -3 | None | Get monitor tables -- | 
| | | Part I | 
| | | | | 
| UU.NLG -2 | SWCTL | Disable logins | 
| | | 
| UU.YLG | -l | SWCTL | Enable logins | 
| | | 
| UU.PAS | 0 | write acct | Create user account | 
| | | | | 
| UU.DLU | 1 | write acct | Delete user account | 
| | | | | 
| UU.MNT | 3 | MOUNT | Disk pack status | 
| | | | 
| UU.LIN | 4 | None | Login | 
| | | | | 
| UU.BYE | 5 | WACNT | Logout | 
| | | EXTQA | | 
| | | | | 
| UU.ATT | 6 | write acct | Attach | 
| | | DEVICE | Reattach | 
| | | Swap console | 
| | | | 
| UU.DET | q | JOBCTL | Detach | 
| | | EXQTA | | 
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-UU0 


Table 3-10: .UUO Subfunctions - Calls to the File Processor (FIP) 


(Cont. ) 
teeter ee eee eee poet eee eee eee tere eee e ee eee terre ete ee ee eee ee ee eee eee eee 
| | BASIC=PLUS | | 
| | SYS Call | | 
| | Code | Privileges | 
| Mnemonic | (Decimal) | That Apply | Function 
terre ee ee eee eee toe eee ee ee eee tere eee eee eee Herre e e  ee e e e e  e  e  ee e eeee 
| | | | 
| UU.CHU | 8 | write acct | Change password/quota 
| | | JOBCTL | Kill job 
| | | HWCTL | Disable terminal 
| | | | 
| UU.ERR | 9 | None | Return error message 
| | | | 
| UU.ASS | 10 | DEVICE | Allocate/reallocate 
| | | HWCTL | device * 
| | | | 
| UU.DEA | 11 | None | Deallocate device * 
| | | 
| UU.DAL | 12 | None | Deallocate all devices * 
| | | | 
| UU.ZER | 13 | DEVICE | Zero a device 
| | | write acct | 
| | | | 
| UU.RAD | 14 | write acct | Read or read-and-reset 
| | | | accounting data 
| | | | 
| UU.DIR | 15 | DEVICE | Directory lookup on index 
| | | execute or | Special magnetic tape 
| | | read file | directory lookup 
| | | | 
| UU.TRM | 16 | HWCFG | Set terminal 
| | | | characteristics 
| | | | 
| UU.LOK | 17 | DEVICE | Disk directory lookup on 
| | | read file | file name 
| | | | Disk wildcard directory 
| | | | lookup 
| | | | | 
| UU.CHE | 19 | TUNE | Enable/disable disk 
| | | | caching 
| | | 
| UU.CNV | 20 | None | Date and time conversion 
| | | | 
| UU.SLN | 21 | INSTAL | System logical names 
| | | | 
| (.MESAG) | 22 | SEND | Message send/receive 
| | | SYSIO | 
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Table 3-10: .UUO Subfunctions - Calls to the File Processor (FIP) 


(Cont. ) 
torent ee ee eee +e eee eee ee eee tee eee ee ee eee ter eee ee ee ee ee ee ee ee eee 
| | BASIC-PLUS | | 
| | SYS Call | | 
| | Code | Privileges | 
| Mnemonic | (Decimal) | That Apply | Function 
te -- ee eee ee eee +------------ +------------ tee eee ree ee ee ee ee eee ee eee 
| | | | 
| UU.SWP | 23 | r/fw files | Install, remove, list 
| | | INSTALL | system files 
| | | | 
| UU.JOB | 24 | WACNT | Create job 
| | | JOBCTL | 
| | | EXQTA | 
| | | | 
| UU.PPN | 25 | DEVICE | Wildcard PPN lookup 
| | 
| UU.SYS | 26 | JOBCTL | Return job status 
| | TUNE | information 
| | | | 
UU. PRV | 28 | None | Set/clear/read current 
| | | privileges 
| | | | 
| UU.STL | 29 | HWCTL | Stall/unstall system 
| | | | 
| UU.3PP | 31 | None | Third-party privileges 
| | | | 
UU.CHK | 32 | None | Check access function 
| | | | 
UU.ONX | 33 | DEVICE | Open next disk file 
| | | DATES | 
| | | r/w files | 
| | | | 
| UU.CFG | 34 | HWCFG | Change system 
| | | SWCFG | characteristics and 
| | | HWCTL | device defaults 
--- =— = 2s e= ewe weer eee wewrewmenwneszs ee eee wee eee ewww ere ew eee ere eee eee se ese eeee we ee ees ee @ © eo 
| * To assign or conee a a user logicals, use .ULOG. 
i a ao a a ee 
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- UU0 
UU.ACT 
UU.ACT (Accounting Information Dump) 
Privileges Required 
GACNT or WACNT is required for access to accounting data. 
Data Passed 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
LUSAAAAISIAIAAIIISIS IIIA II ISSA IISA ISAS 111177 \— ® 
FQFUN 3 | UU.ACT (= -17) VALLE hh: 
5 Ga tee Ls 4 
7 | project number 1 programmer number | 6 FQPPN 
11 ENG ES AAA LER EL ESAS LAA MAA le CL 10 
13 Veaaddiadiddididda 12 
15 Vad 14 
17 I LPILLLLILPILT IL ILILL IL ELTLA LILIA EL IL TDD TD 16 
ZL VSSALAISAAIIIIIIIAAAA ALIA AAAS A AAAS S117 | 20 
23 OO ee a 22 
25 Veeaaaaadadaidida 24 
27  PPILILLILILLIPILILLILILALL IL ILADD DILATED 26 
31 AE ie AAA AA BAAS ELEAE SARE EEEE SEALE 30 
33 Vad 32 
35 WLLL 34 


37 WLLL 36 


FIRQB+FQPPN Zero in both bytes means the current account. 
Data Returned 
Except for a possible error in byte 0 of the FIRQB, The UU.ACT 


subfunction of .UUO does not return any meaningful data. 
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UU.ACT 
' Errors 
NOSUCH The account specified does not exist. 
PRVIOL A caller with GACNT privilege specified an account 


outside the caller’s group. 
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UU.ASS 

UU.ASS (Allocate/Reallocate Device) 
Privileges Required 


DEVICE is needed to allocate a restricted device. HWCTL is required 
to seize a device or reallocate a device to a job in another account. 


Data Passed 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
VALE LEME RAMA LE 
FQFUN 3 | UU.ASS (= 12) WAAL he 
) AEA EES AANA EEL EE LAL ADAIEL Lila Mla ie 4 
7 WP LILILL ILL ILILLTLLIPILL ALT EL LALIT ALTE 6 
11 WO ETC 0,alloc.;#40,realloc.| 10 FQNAMI1 
13 WELLE 12 
LB «| DOS or ANS in RAD50 format (1 word) | 14 FQEXT 


LP SSSSSSASSSSASA SSSA SAAS S AAAS AAAS SSS 77 | V6 


23 | 100001 for seize; else 0 | 22 FQMODE 


31 | device name (2 nee characters) | 30 FQDEV 


33.1 #0,unit no. real | device unit number | 32 FQDEVN 
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Data Returned 
FIRQB 


FIRQB+FQFIL 


Errors 


BDNERR 


INUSE 


NODEVC 


NOTAVL 


PRVIOL 


-UU0 
UU.ASS 


error code (if any). 
previous owner of the device as follows: 


If you own a device already and allocate it, UU.ASS 
returns your own job number. 


If you seize a device, you can see who you seized 
it from. 


If you reallocate the device, you can see who owned 
it before the reallocation. 


If the value in FIRQB+FQFIL is zero, then you know 
that the device was not previously owned. 


Your program attempted to reallocate a device to a 
nonexistent job. 


For 


a reallocate, the specified device is open or has 


an open file. 


Device name at FIRQB+FQDEV is not a valid device name 
on this system. 


The 


device specified exists on the system, but the 


operation failed for one of the following reasons: 


.e) 


You 


The device is currently reserved by another job 
(see description of FIRQB+FQMODE). 


The device or its controller is disabled. 


The device is a keyboard line for a pseudo keyboard 
only. 


you do not have DEVICE privilege and the device is 
restricted. 


do not have the required privileges and tried to 


reallocate a device to a job that is logged in to an 
account other that you current account. 


-UU0 


UU.ATR 

-UUO 

UU.ATR 

NOROOM Occurs only on awrite. The User File Directory (UFD) 
of the account is full. Some files must be deleted to 
free entries for attributes. 

NOTOPN Channel specified at FIRQB+FQFIL must have file open. 

PRVIOL Job does not have read/write access to the file open on 


the channel, or a UFD is open on the channel. 
Privileges Required (Read/Wwrite/Delete Account Attributes) 


No privileges are required to read attributes 1, 2, and 4 to 191 of 
your own account. That is, of the DIGITAL-defined attributes you can 
read all except the password. Of the user-defined attributes (128 to 
255) you can read the first 64. To read attribute 3 (password) or 
attributes 192 to 255, you need GREAD, WREAD, GACNT, or WACNT 
privilege. 


Read or accounting privileges (GREAD, GACNT, WREAD, or WACNT) are 
required to read accounting data of other accounts. Accounting access 
(GACNT or WACNT) is required to write or delete accounting data of any 
account. 


-UU0 


UU.ATR 
Data Passed (Read/Write/Delete Account Attributes) 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
i Sr + 
1 IO NR 0 
is + 
FQFUN 3 | UU.ATR (= -31) |/Y/PILLILLILILLILL ILS 2 
tener eee ee eee ee eee Sn + 
FQSIZM 5 | attribute type code | subfunction code | 4 FQFIL 
Sl Si + 
7 | project number | programmer number | 6 FQPPN 
Hn ee ee ee eee + 
11 | | (see discussion) | 10 FQNAM1 
+ Se + 
13 | | 12 
+ 13 bytes of data + 
15 | (only on write) | 14 
+ + 
17 | | 16 
+ + 
21 | | 20 FQNAM2 
+ + 
23.4 | 22 
+ + 
25 | | 24 
+ sess ea me ees eee eee ew kee ew ee see ewe weewmne eee ewe ee ew o@ + 
27 ALLLLLLLLLLLLLLLLLLALLLLLLLLLLLLLLLLLLL LT 26 
He ee ee ee ee eee eee + 
31: device name (2 ASCII characters) | 30 FQDEV 
Hr ee ee ee ee eee + 
33 | 0, unit no. real | device unit number | 32 FQDEVN 
Se toner ee ee ee ee ee eee eee + 
35 LLLLLLLLLLLLLLLLLLLADEAAAA AA AAA D | 34 
tone eee ee ee eee eee eee terre rr ee eee eee eee + 
37 DOP Ge OL 36 
Si oe iS + 
FIRQB+FQFUN The function code UU.ATR (octal value = -3l1). 
FIRQB+FQFIL The subfunction code: 


1 Read account attributes 
~2 Write account attributes 
-3 Delete account attributes 
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UU.ATR 


FIRQB+FQSIZM 


FIRQB+FQPPN 


FIRQB+FQNAM1 


FIRQB+FOQNAM1+1 


The attribute type code: 


Look-up by index 

Quotas 

Authorized Privilege Mask 
Password 

Date/time information 
User name information 
Nondisk quotas 


Aw B&B WN FEF © 


The PPN of the account accessed. The project number is 
in the high byte (FQPPN+l1), and the programmer number 
is in the low byte (FQPPN). A value of zero defaults 
to the caller’s PPN. 


The index in a “look-up by index." Look-up by index is 
specified by using a type code of zero in FIRQB+FQSIZM 
and -l in FIRQB+FQFIL. For programs like BACKUP, it is 
useful to read all the account attributes without. 
having to try each of the 255 possible type codes. The 
value n of the index specifies that you want nth 
attribute type. 


The account attributes to be written to one attribute 
block. The data is written exactly as passed except 
for attribute types 2 and 4. 


For type 2 (authorized privilege mask), when writing 
the mask, any attempt to turn on privilege bits are 
ignored if the caller does not have the corresponding 
privilege currently in effect. The layout of the 13 
bytes are: 


o FIRQB+11 -- reserved 
Oo FIRQB+12 through +21 -- authorized privilege mask 
Oo FIRQB+22 through +25 -- reserved 


For type 4 (date/time information), the last log-in 
fields are always left alone. This ensures that any 
logins to an account leave a trace that cannot be 
tampered with. The layout of the 13 bytes are: 


oO FIRQB+11 -- keyboard of last login (-1 if detached) 
o FIRQB+12,+13 -- date of last login (RSTS internal 
format) 
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FIRQOB+FQDEV 


FIRQB+FQDEVN 


-UU0 


UU.ATR 
o FIRQB+14,+15 -- time of last login (RSTS internal 
format) 
© FIRQB+16,+17 -- date of last password change 
O FIRQB+20,+21 -- time of last password change and 
flags 
O FIRQB+22,+23 -- date of account creation 
Oo FIRQB+24,+25 -- expiration date (-1 if none) 
The flags in FIRQB+14,+15 are: 
o Bit 11 -- no password required ("guest" account) 
o Bits 12-15 -- reserved 
The flags in FIRQB+20,+21 are: 
o Bit 11 -- password cannot be looked up ("hashed" 
password) 
o Bit 12 -- no dial-up logins allowed 
o Bit 13 -- no network logins allowed 
o Bit 14 -- no interactive logins allowed (spawn and 


batch only) 
o Bit 15 -- captive account 


If bit 11 is set, then passwords can be up to 14 
characters long and the system stores them in hashed 
form. The hash uses parts of the date/time attributes; 
so, altering any bits of bytes FIRQB+16 through 
FIRQB+23 (except for the flag bits) renders the 
password useless. The read accounting data directive 
(UU.RAD) returns two zero words if this bit is set. 


If bit 11 is clear, then passwords can be up to six 
characters long and must consist of uppercase letters 
and numbers; that is, the RAD50 character set. 


The device name passed; two ASCII characters. A value 
of zero indicates "SY", public disk. 


The device unit number passed in binary notation. A 
nonzero value in the high byte of this word 
(FIRQB+FQDEVN+1) indicates an explicit device unit 
number. A zero value in the high byte indicates no 
unit number. 


3293 


-UUO 
UU.ATR 
Data Returned (Read/Write/Delete Account Attributes) 


Other than a possible error in byte 0 of the FIRQB, data is returned 
only on a read subfunction (-1 in FIRQB+FQFIL). 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset . Offset monic 
Se a a + 
1 LLLILLILATLALL ILA PALLALTILALA ADAP ELATED 0 
i Se + 
3 IASIISIISSI1111///////\ carrent job no. * 2 2 FQJOB 
5 ee 5 + 
5 | attribute type code |J///////////////////// 4 
Se i + 
7 | project number | programmer number 6 FQPPN 
Hr ee ee ee ee ee ee eee eee eee + 
11 | | attribute type 10 FQNAM1 
+ Beet e eee eee ee ee eee eee + 
13 | 12 
+ + 
Lo:.|| 14 
+ + 
17 | 13 bytes of data 16 
+ + 
21 | 20 
+ + 
a3. 4 | 22 
+ + 
25 | | 24 
Hen ee ee ee er ee ee ee ee eee + 
27 UIE LOL 26 
-— ee es se eee eereees se se eeereeeaeereeeeseeeweeseeeseeeeeeeese es m= + 
31 Ween 30 
tern re ee ee ee ee ee ee ee ee ee ee ee eee + 
33 CARA AE EMSA MiMi OMAN AAAS ELEE HARARE EEG 32 
tare rr pe ee ee ee ee ee eee ee eee + 
35 PLLILLILL ILA ILL IPAS PALLILLPPALAIPAPL TD ADD | 34 
tar ee ee ee ee ee ee ee eee ee ee eee + 
STNALSLTLISILT SITS S SAAS TASS AA AAAS ATT AS AAS 77 \. 30 
i Se + 


FIRQB+FQNAM1 The attribute type code. Contains the type code of the 
attributes just read (same as passed except for lookup 
by index). 


FIRQB+FQNAM1+1 The actual attribute data. 
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UU.ATR 


Errors (Read/write/Delete Account Attributes) 


DEVNFS 


EOF 


NODEVC 


NOROOM 


NOSUCH 


NOTMNT 


PRVIOL 


The specified device is not a disk. 

The attribute type not found (read or delete only). 
The index specified for an indexed look-up call is 
greater than the number of attributes (read only). 


The specified device does not exist. 


The attribute block did not exist and it cannot be 
added because the directory is full (write only). 


The specified account does not exist. 

The specified disk is not mounted. 

You do not have sufficient privilege for the operation. 
The disk is write-locked (write and delete only). 


Attempt to delete in the DIGITAL-reserved type range 
(delete only). 
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Privileges Required (Read Pack Attributes) 
DEVICE is required if the device specified is restricted. 
Data Passed (Read Pack Attributes) 
FIRQB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 


1 WLLL 0 


FQFUN 3 i UU.ATR (= -31) VALILILILILTILILILILT | 2 


Henne eee eee eee ee eee teen eee ee ee eee eee + 


SISAISIIIIA1S111/1/////\subtunction code (-4)| 4 FQFIL 
Hence eee eee eee ee eee Herre ee eee ee eee eee + 


TVSSSAAAIIISIIIIITATA LSAT AA AAA SA SSSA 1111177 | ®& FQPPN 
LL YSSSSIIAIIIISASAI IAAL ISI AT IIASA SSAA S117 | 10 FQNAML 


LS VSASSSSAAASIISASII IAAI AAAS IIIA SSSA S AS11177 \ 14 FQERT 
i VAAL he ee 
ZL YSSSAIIISISIIS IIS ITTS II AAL IASI IAA S AAAS 1 177 \ 20 FQNAM2 
2B SSIIIIIISIIIIIAIAII IIIA TATA IAAI T 111111 22) FQMODE 
2D VSAAIIIIIIIIISIAI ITAL IIASA I IAA ISSA 1111717 \ 24 FQPLAG 
2TVSASSISIIAIIIASIA ISAS IISA IASI AAAS AS11111 17 26 FQPFLG 
31 | device name (2 ASCII characters) | 30 FQDEV 


33 | #0, unit no. real | device unit number | 32 FQDEVN 
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Data Returned (Read Pack Attributes) 


This call 


in. 


Mne- Octal 
monic Offset 


1 


3 


-UU0 
UU.ATR 


returns information about mounted disks. It is used to 
obtain the characteristics of a disk and the drive the disk is mounted 


FIRQB 
Octal 
ee + 
Vad 0 
cs + 
Vdd 2 
a ee es + 
Ueda 4 
Se ee + 
SP LLLILLLPLISLALLASLSL APL PLLAALATPPTDPATDOTY | 6 
Herr rr ee ee eee + 
| lst DCN of MFD | 10 
He ne ee ee eee + 
| Pack Revision Level | 12 
Hen ee ee ee eee + 
| Pack Cluster Size | 14 
Herr ee ee ee ee ee ee ee ee eee + 
| Pack Status/Flags | 16 
Hen re ee ee er ee eee + 
| Pack ID in RADS50 format | 20 
+ + 
| (in 2 words) | 22 
pene ne ee ee ee ee ee ee ee eee + 
| Size of disk in DCNs | 24 
Hen ee ee ee ee ee ee ee ee eee + 
| Device Cluster Size | 26 
tmnt er ee eee + 
ALLLLLLLTLLLLLLLL LLL LLLLLLLLLLLLL LLL LL LLL \ 30 
Se ee + 
VALLLLLLLLLLLLLLL LLL LLL LLL LLL LL LL LL LL LL LLL | 32 
Heer er re ee ee ee eee ee terre ee ee ee ee ee eee + 
PLLLLLLLLLLALAAAALLLLLAAAAA LALLA ALAL 34 
Hen ee ee ee ee eee + 
UEDA MALE AREAACRGEE CHAE AE AGE ERAS SEL 36 
FIRQB+FQNAM1 The starting device cluster number (DCN) of 


FIRQB+12 


The pack revision level. 


FIRQB+FQEXT The pack cluster size. 
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Mne- 


Offset monic 


FOQNAM1 


FQEXT 
FQSIZ 
FQNAM2 
FQMODE 
FQFLAG 


FOQPFLG 


the MFD. 


-UU0 
UU .ATR 


FIRQB+FQSIZ 


FIRQB+FQNAM2 


FIRQB+FQFLAG 
FIRQB+FOPFLG 
Errors (Return 
DEVNFS 


NODEVC 


The pack status/flags. The defined bits are: 
o Bit 9 -- Pack is initialized "new files first" 


o Bit 11 -- Pack is initialized to maintain date of 
last write 


o Bit 12 -- Pack is initialized as a read-only pack 
o Bit 14 -- Pack is initialized as a private/system 
disk 


All other bits are reserved. 

The pack ID in RAD50 format. The first three 
characters are here and the last three characters are 
in the next word, FIRQB+FQMODE. 

The size of the disk in DCNs. 

The device cluster size. 

Pack Attributes) 


Device specified is not a logically mounted device. 


Device specified is not valid. 
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UU.ATT 
'UU.ATT (Attach/Reattach Job/Swap Console) 

Privileges Required 
DEVICE is required to perform a REATTACH if the terminal is 
restricted. GACNT or WACNT is required to ATTACH to a job outside the 


caller’s account. 


Data Passed - Attach 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se Sl + 
LUSSAAAISISSIAAIAAIL AAAI AIAN AAA AAAS AAAS 171 
Se a + 
FQFUN 3 | UU.ATT (= 6) VAAL hhh 
Se Sl + 
FQOSIZM 5 | bit mask | job number to attach| 4 FQFIL 
Heer cee eee ee ee ee eee Se + 
7 | project number | programmer number | 6 FQPPN 
tere ee eee eee ee eee eee terre tere ee ee eee eee eee + 
11 | password in RAD50 format | 10 FQNAM1 
+ + 
13 | (2 words) | 12 
+ + 
15 | or | 14 
+ + 
17 | password in ASCII format | 16 
+ + 
21 | (7 words) — | 20 
+ + 
23° | 22 
+ + 
25). | 24 
Hr ee ee ee ee ee ee ee ee eee + 
27 OLE ACAPELLA ELLE | 26 
Sr i oe + 
31 UZ eaddaaaadiadia 30 
Se is + 
33 Vad 32 
Se + 
35 VL aaaddddidda 34 
+ eee es we we eer eezeereeneneezmeneweecke we she ew we eeerwneseemnwewewes eee we 
37 ITIL \ 36 
Horr eee ee ee ee eee Sl + 
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FIRQB+FQSIZM Bit O must be clear for the attach subfunction. 


Bit 1 is clear for the old password format (RAD50) and 
set for the new format (ASCII). 


Bit 2 can be set on an attach to suppress the password 
check. If clear, the password is checked if you attach 
to a job in another account. 

All other bits are reserved. 

FIRQB+FQPPN zero in both bytes means your PPN. You do not need to 
include a password. If you do not have GACNT or WACNT 
privilege, you can only specify your own PPN. 

FIRQB+FQNAM1 You must include a password if you specify a PPN other 
than your own unless bit 2 is set in FIRQB+FQSIZM. 
Note that this use of the call requires GACNT or WACNT 
privilege. 

Data Returned 


Other than a possible error in byte 0 of the FIRQB, the attach 
function of the UU.ATT directive does not return any data. 


Errors 


BADFUO The system returns this error for one of the following 
reasons: 


o Job executing the call has an open channel. 
o Job executing the call is detached. 


o Caller is a source (BAS) program rather than a 
compiled (BAC) program. 


o Job number at FIRQB+FQFIL is not detached. 


o The PPN specified does not match PPN of job to 
attach. 


o Caller does not have GACNT or WACNT privilege, and 
the job to attach to has a PPN different from that 
of the caller. 


o Password is not valid. 
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Data Passed ~ 


Mne- Octal 


monic Offset 


FQFUN 


FQSIZM 


1 


Reattach 
FIRQB 
Octal 
Offset 
wee eee ee ee eee ee ee eee en. 
UV dddddddaddia 0 
ee ee + 
| UU.ATT (= 6) VPASLIPLILYILLILLALID 2 
we ee ee ee ee ee eee tare eee ee ee ee ee et 
| KB no. to attach to | caller’s job number | 4 
we ee ee ee eee eee Se 


Data Returned 


-UUO 
UU.ATT 


Mne- 
monic 


FOQFIL 


Other than a possible error in byte 0 of the FIRQB, the reattach 
function of the UU.ATT directive does not return any data. 


Errors 


BADFUO 


The system returns this error for one of the following 
reasons: 


oO 


Job number at FIRQB+FQFIL is out of range or no 


such job exists. 
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Data Passed - 


Mne- Octal 
monic Offset 


FOQFUN 


FOQSIZM 


1 


5 


o Caller is not detached. 
o KB number is out of range. 


o KB is currently allocated, opened, or the console 
keyboard of some job other than the calling job. 


o The terminal is restricted and the caller does not 
have DEVICE privilege. 


Swap Console 


Octal Mne- 
Offset monic 


OO EA OE BCE GR Ae eee 0 


bit mask aoe no. to swap with | 4 FQFIL 
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FIRQB+FQSIZM 


FIRQB+FQFIL 


Data Returned 


-UU0 
UU.ATT 


Bit 0 must be set for the swap console subfunction. 
All other bits are reserved. 

If the calling job is attached, this job must be 
detached. If the calling job is detached, this job 


must be attached. Both the calling job and this job 
must be running under the same PPN. 


Other than a possible error in byte 0 of the FIRQB, the swap console 
function of the UU.ATT directive does not return any data. 


Errors 


BADFUO 


The system returns this error for one of the following 
reasons: 


o Both the calling job and the job specified at 
FIRQB+FQFIL are detached, or neither job is 
detached. 


o The job specified at FIRQB+FQFIL has a PPN 
different from the caller’s. 


o The value at FIRQB+FQSIZM is neither 0 nor l. 
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UU.BCK (Change File Statistics) 
Privileges Required 
DATES is required to change the last access date. 
Data Passed 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herre ee ee ee ee ee eee Se + 
1 ee, 0 
FQFUN 3 | UU.BCK (= -13) V/YAPLIALILLPSLYTLY LLL 2 
FOSIZM 5 | LSB of last access | channel no. (1-17) | 4 FOFIL 
7 |LSB of creation date | MSB of lage access | 6 FQPPN 


11 |LSB of creation time |MSB of creation date | 10 FQNAMI1 


3 |SAASSSISS1111////////\4SB of creation time | 12 
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UU.BCK 
FIRQB+5,6 The system internal format for dates has the form: 
FIRQOB+7,10 
[(year - 1970) * 1000) + day-within-year 
FIRQB+11,12 Time is specified in minutes until midnight, where 1440 
equals midnight. 
Note 

See the .DATE directive for a discussion of these 

formats. 
Data Returned 
Other than a possible error in byte 0 of the FIRQB, the UU.BCK 
subfunction does not return any meaningful data. 
Errors 
BADFUO The file open on the channel specified is either not a 


disk file or is a user file directory (UFD). 
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UU.BYE 

UU.BYE (Logout) 
Privileges Required 


EXQTA is required to log out without a quota check. WACNT is required 
to log out without a self-kill. 


Data Passed 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 LPLLILLILIILILA LILA IPULD IL ELA ADI LADD ID TED 0 
FQFUN 3 | UU.BYE (= 5) WALA: 
DS VSASASSASSSSS11 1411107 | type of logout | 4 FQFIL 
i VAAL hhh 
LL SSSSSSASSISSIAISAS ISLA A AAAS A AAAS S117 7/7 \ 10 
13 TALC AIA ACE GEE AUGER LEGER EE EAA AE Gi 12 
15 Vea 14 
17 Waa 16 
21 Veal 20 
23 Ueda 22 
25 Ueda 24 
27 Ueda 26 
31 Vad 30 
33 Vad 32 
35 Vaan 34 
37 LPLLILLILLLT IL ILILTIPELTLLITIPALDIDIDILTD 6 
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FIRQB+FQFIL Bits 0 and 1 specify: 


Bit Setting 


0 Clear 
Set 

1 Clear 
Set 


Meaning 


Close I/O channels, deassign devices, 
remove receivers, and dismount disks 
mounted /NOSHARE before performing 
logout. 


Perform logout only; do not close 
channels, deassign devices, remove 
receivers, or dismount disks. This call 
requires WACNT privilege. 


Check quotas on all mounted disks 
before performing logout. 


Perform logout without checking disk 
quotas. This call requires EXQTA 
privilege. 


If the caller does not have WACNT privilege, RSTS/E 
forces Bit 0 to zero. If the caller does not have 


EXQTA privilege, 


RSTS/E forces Bit 1 to zero. 


Bits 2 through 7 are reserved. 
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Data Returned 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herren ete eee eee eee Herren ee ee eee eee ee + 
LVSAASSAIIAIALSSSIIIAA SAIS SSAA I AAAS AS11114 \ 9 
POPUN 8B IY/LLIIIIIVIIILIVITI VIII LLIUITIT\ 2 
1 ee logout status (0, -1, or -2). | 4 FOIL 
TILT 8 
LL IIIT LILI VTL 
13/2 
VEEL 
LI WV/IIIIIIIIIIIIII1//\——sqaoka code ———*|-16 FOSTZ 
21 | MSB of current usage| MSB of current quota] 20 FONAN2 
23 [no. of det. jobs all.| no. of det. jobs | 22 FQMODE 
25 | LSB of current disk quota (in blocks) | 24 FOFLAG 
27 | LSB of current aisk usage (in blocks) | 26 FOPFLG 
a1) disk name (2 ASCII characters) | 30 FODEV 
33 | #0, unit no. real | disk unit number | 32 FODEVN 
85 IIIT IVIL TLL 
37 Wea 36 
FIRQB+FQFIL Zero means neither disk quota nor detached job quota is 


exceeded. If you have WACNT privilege, the system 
returns control to your program. Otherwise, the system 
kills your job after performing necessary clean-up 
functions. 


Minus one means a quota is exceeded; your job is still 
logged in. 
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FIRQB+FQSIZ 


FIRQB+FQMODE 


FIRQB+FQDEV 
Errors 


No errors are 


-UU0 
UU.BYE 


Minus two means a quota is exceeded, but your job is 
logged out. If you have WACNT privilege, the system 
returns control to your program. Otherwise, the system 
kills your job after performing necessary clean-up 
functions. 


Indicates which quota is exceeded. (This value is 
valid only if FIRQB+FQFIL equals -1 or -2.) 


zero means disk quota. 
One means detached job quota. 


Returned if detached job quota is exceeded. 
FIRQB+FQMODE contains the number of detached jobs in 
the current account. FIRQB+FQMODE+1 contains the 
number of detached jobs allowed. 


Returned if disk quota is exceeded. 


possible with the UU.BYE subfunction. 
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- UUO 

UU.CCL 

UU.CCL (Add/Delete CCL Command) 

Privileges Required 

INSTAL is required to add or delete a CCL command. 


Data Passed ~- Add 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Sel tone ee ee eee tee + 
LSAAAAIISAAIIAS AAAI AAAS ASIA AAAS S111 7 9 
tee ee ee ee ee eee ee ee eee tee ee ee ee ee ee eee eee + 
FOQFUN 3 | UU.CCL (= -30) WAAL: 
tern ee ee ee eee ee eee tere re ree ee ee eee + 
FQOSIZM 5 | abbrev. point, chars| must = 0 for add | 4 FQFIL 
tere eee ee eee eee eee eee tern er ee ee ee eee + 
7 | project number | programmer number | 6 FQPPN 
St tence rte ee ee eee eee eee + 
ll | file name in RAD50 format | 10 FQNAMI 
+ of program to run + 
13 | (2 words) il, az 
Herr ee er ee ee ee ee eee +------ eee ee eee ee eee + 
1S | file type in RAD50 format (1 word) | 14 FQEXT 
tener er ee eee eee eee tener ree ee eee ee ee ee eee + 
17 | CCL command -- one to nine characters | 16 FQSIZ 
+ padded with NULS (ASCII code 000) + 
21 | to nine characters | 20 
+ + 
23 | | 22 
+ + 
25: | 24 
teen eer ee eee eee eee + + 
FQPROT 27 | (must be 0) | | 26 
tee 2 eee ee ee ee eee eee eee tee ee ee ee ee ee eee eee + 
31 | device name (2 ASCII chars) must be disk | 30 FQDEV 
Herre ee ee eee eee +--- 2 ee ee ee ee ee eee eee + 
33 | #0,unit number real | device unit number | 32 FQDEVN 
terre ee ee ee eee eee teeter ee eee eee eee eee + 
35 | line number to start execution | 34 FQCLUS 
teen eee ee ee ee ee eee eee t- 2 - ee ee ee ee ee ee eee + 
37 LLLLLLLLLLLL LLL LLL LLL LL LL LL LLL LLL LLL LLL LLL | 36 
St tence ee ee eee eee ee + 
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UU.CCL 
Data Passed - Delete 
FIRQB | 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se + 
1 Vad 0 
+ ees ec eo wm we we ew eeweseeweeee ee ow + =e se et we we we ewww esewnwe eee Ss = 
FQFUN 3 | UU.CCL (= -30) WEEE 2 
terre ee ee eee eee eee terre re ee ee ee eee + 
FQOSIZM 5 | abbrev. point, chars| = -2 for delete | 4 FQFIL 
Se terre er ee ee eee eee eee + 
7 ELIOT CIEL OC HL ENT EGE CLIN 6 
Se + 
11 Veddadadadiddida 10 
Sl + 
13 WEEE 12 
tence eee eee ee ee eee eee tee ee eee ee ee eee ee eee + 
15 UO AE CAE la L GAME AMAL E EEA, 14 
Se oe + 
17 | CCL command -- one to nine characters | 16 FQSIZ 
+ padded with NULs (ASCII code 000) + 
21 | to nine characters | 20 
+ + 
23° | | 22 
+ + 
25°'] | 24 
Sr + + 
27 OA EE GMOS ES AAG | 26 
Se oe ie + 
31 SP SLILLATPALLAALTTLLTLPALLAPPATLAADLDDDTD DE 30 
terre rr eee ee eee eee eee terre ere eee ee eee eee + 
33 MOT GO GR 32 
Se oe + 
35 Vdd 34 
Se i + 
37 A LLPILLILL ALA ILALLA TLL ADAALPITLAPPTIDIDLTD LD 36 
prec ee e ee ee eee ee terre cee ee ee eee eee + 
Data Returned 
Except for a possible error in byte 0 of the FIRQB, the UU.CCL 
directive does not return any meaningful data. 
Errors 
BADNAM For add only. The CCL command either begins with a 
number or contains an otherwise unacceptable character. 
INUSE For add only. The CCL command is already defined. 
NODEVC For delete only. The CCL command does not exist. 
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FIRQB+FQPPN 


FIRQB+FQPPN+1 


Parameter change flags: 


Bit Setting 


0 Clear 
Set 

1 Clear 
Set 

2 Clear 
Set 


No change 


Use value 
status 


No change 


Use value 
ownership 


No change 


in 


in 


in 


in 


in 


Meaning 
enable/disable status 


FIRQB+FQPPN+1 to change 


device ownership 


FIRQB+FQPPN+1 to change 


modem control 


Use value in FIRQB+FQPPN+1 to change 


modem control 


All combinations of the bit values are legal. 


If FIRQB+FQPPN is zero, 


then this byte should also be 


zero. If FIRQB+FQPPN is not zero, then the following 
values are used to alter device parameters: 


Bit Setting 


0 Clear 
Set 

1 Clear 
Set 

2 Clear 
Set 


Enable device 


Meaning 


Disable device 


No privilege needed for device 


ownership 


DEVICE privilege needed for device 


ownership 


Put device under LOCAL control 


Put device under MODEM control 


Data Returned (Set DEVn: characteristics) 
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Except for a possible error in byte 0 of the FIRQB, the system returns 
the following: 


Mne- Octal 
monic Offset 


1 


3 


FIRQB 


WLLL 


ce + 


PILI ILILLLT ITLL TST UL ILT ADELA ALITTLE 
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Octal Mne- 
Offset monic 


6 FQOPPN 
10 
12 
14 
16 
20 
22 
24 
26 
30 
32 
34 


36 


-UUO 
UU.CFG 
Errors (Set LPn: characteristics) 


BDNERR An attempt was made to set both bits 0 and 1 in the 
characteristics flag word. 


NODEVC An attempt was made to set characteristics of a printer 
which is not supported by the monitor, or the device 
name specified in FIRQB+FQDEV was not LP. 

Data Passed (Set System Defaults) 

FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 CL GL OE 0 
FQFUN 3 | UU. CFG (= 42) V/PYISLLLTILLILLLLY LE 2 
S ISASSIIIII111111//////\ saubtunction code =2 | 4 FQFIL 
7 | powerfail delay in seconds | 6 FQPPN 
11 | default time format | default date format | 10 FQNAM1 


13 | default tape density| default tape label | 12 


31 Vad 30 FQDEV 
33 Veda 32 FQDEVN 


BT VSASASSSTISISIAIAS ISAS A IAA ASA ASIA AAAS SAAS 17 \ 36 


FIROB+FOQPPN Default powerfail delay in seconds. Zero indicates no 
change. A nonzero value represents the new default 
powerfail delay. The maximum is 454 (octal) seconds. 
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Data Passed - Delete 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tn n eer ee eee ee ee eee eee tere ee eee re ee eee eee eee + 
1 HI COO Ree 0 
Se oe + 
FQFUN 3 | UU.CCL (= -30) WLLL 2 
+ re i ee ee 
FQSIZM 5 | abbrev. point, chare| = -2 for delete 1 4 FQFIL 
Se + 
7 WEEE EEE 6 
Se terre er re tee eee eee + 
11 ARAN AEA RAL SAAR ERE SEERA SAS GAEL SALSA 10 
ee + 
13 Vad 12 
a + 
15  PLLLIPLLSLLTLLATLATLLAAPA ALLA A APT ALATLE 14 
Hern eee eee ee eee eee teen eee eee eee eee eee + 
17 | CCL command -- one to nine characters | 16 FQSIZ 
+ padded with NULs (ASCII code 000) + 
21 | to nine characters | 20 
+ + 
23 | | 22 
+ + 
25) | 24 
Herr ere ee ee eee eee + + 
2T SASSI IASAISS SASS 1110S | | 26 
tener eee ee ee eee eee terre eee re ee eee ee eee + 
31 NEE AN A MANGE CREE CALEA RAMA L EERE EEL GAG! 30 
+ ese ese em eee we3wen wr mrnenVnrwsenee eek we ec ee ew ew ew ee ew ee ee ee ee el 
33 Vdd 32 
Se ee ee + 
35 Vdd 34 
Sr ie + 
37 SP PLLLILILLILILL LILLIA PLPLAPALT ALTA IL ED ALL | 36 
Sr tee ee ee re ee eee eee eee + 
Data Returned 
Except for a possible error in byte 0 of the FIRQB, the UU.CCL 
directive does not return any meaningful data. 
Errors 
BADNAM For add only. The CCL command either begins with a 
number or contains an otherwise unacceptable character. 
INUSE For add only. The CCL command is already defined. 
NODEVC For delete only. The CCL command does not exist. 
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UU.CFG (Set Device/System Default Characteristics) 
Privileges Required 
HWCFG is required to: 
o Declare a device as restricted or unrestricted 
o Set magnetic tape default density 
o Set line printer characteristics 
SWCFG is required to: 
o Set magnetic tape label defaults 
o Set power fail delay 
o Set date/time presentation formats 
o Set system flags 


HWCTL is required to enable/disable a device. 
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Data Passed (Set DEVn: characteristics) 


Mne- 


FQFUN 


Octal 
monic Offset 


1 


3 


FIRQB 


ASILISTTTS TAL 111 /////\ sabfunction code =0 | 


tenn rere ee eee ee eee Si + 


| parameter switches | par. change flags | 


| 377 | device unit number | 
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Octal 
Offset monic 


0 


2 


4 


6 


10 


12 


14 


16 


20 


22 


24 


26 


30 


32 


34 


36 
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Mne- 


FOFIL 


FOPPN 


FQODEV 


FQDEVN 
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UU.CFG 
FIRQB+FQPPN Parameter change flags: 
Bit Setting Meaning 
0 Clear No change in enable/disable status 
Set Use value in FIRQB+FQPPN+1 to change 
status 
1 Clear No change in device ownership 
Set Use value in FIRQB+FQPPN+1 to change 
ownership 
2 Clear No change in modem control 
Set Use value in FIRQB+FQPPN+1 to change 


modem control 
All combinations of the bit values are legal. 
FIRQB+FQPPN+1 If FIRQB+FQPPN is zero, then this byte should also be 


zero. If FIRQB+FQPPN is not zero, then the following 
values are used to alter device parameters: 


Bit Setting Meaning 
0 Clear Enable device 
Set Disable device 
1 Clear No privilege needed for device 
ownership 
Set DEVICE privilege needed for device 
ownership 
2 Clear Put device under LOCAL control 
Set Put device under MODEM control 
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Data Returned (Set DEVn: characteristics) 
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UU.CFG 


Except for a possible error in byte 0 of the FIRQB, the system returns 
the following: 


Mne- Octal 


monic Offset 


1 


3 


FIRQB 


Octal Mne- 


Vda 


| device parameters H device status flags | 
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Offset monic 


6 FOPPN 
10 
12 
14 
16 
20 
22 
24 
26 
30 
32 
34 


36 


-UUO 
UU.CFG 


FIRQB+FQPPN 


FIRQB+FQPPN+1 


Device status flags indicating: 


Bit Setting Meaning 
0 Clear Device is enabled and free 
Set Device is disabled or in use 
Al Clear Device ownership does not require 
privilege 
Set Device ownership requires HWCFG 
privilege 
2 Clear Device is in LOCAL mode 
Set Device is under MODEM control 


Note that Bit 2 is only valid if the device name passed 
in FIRQB+FQDEV is KB. 


Valid values are: 
0 -- If bit 0 in FIRQB+FQPPN is clear. 


3 -- The device was disabled by this call and can be 
enabled by this call. 


Any even integer -- Job number * 2 of the current 
device owner. 


Any odd integer (other than 3) -- The device was 
disabled by the monitor and cannot be enabled. 


Errors (Set DEVn: characteristics) 


INUSE 


NOTAVL 


PRVIOL 


An attempt was made to disable a device that was in use 
by another user or one that had been previously 
disable. 


An attempt was made to enable a device which was not 
disabled through use of this call. 


An attempt was made to alter device characteristic of a 
disk unit. 
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Data Passed (Set LPn: characteristics) 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herre eee eee eee Horne ere er ee eee eee eee + 
LVSSSALASIISAIISS IIASA ASIII AAAS SASS AAAS 1111/7 \  ® 
rOFUN 3 | DULCE (= 42) YII///IIIIIIIIIIIIN\ 2 
SIIITIIHITII/I//1)| sabeunction code =1 | 4 FQFIL 
7) case flag | default page width | 6 FOPPN 
11 | set characteristics flag bits mask | 10 FQNAM 
13 | clear characteristics flag bite mask | 12 
15 | LPTSPC (ASCII value) |0=no chg/l-chg LPTSPC| 14 FQEXT 
17 | Oeno change, nenew default form length | 16 FOStZ 
VEEL. 
23 IIIT LILI LILI, 
VEEL 
21 WTI LITT LLL, 8 
31 | device name (2 ASCII chars) must be "LP" | 30 PODEV 
31! a7: | device unit number | 32 FODEVN 
VEEL 
37 WLLL 36 
FIRQB+FQPPN Default Page Width; zero indicates no change, nonzero 


indicates the new value for the default page width. 


FIRQB+FQPPN+1 Case flag as follows: 


0 No change 
l1 Printer can use mixed case 
255 Printer can use uppercase only 
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FIRQB+FQNAM1 


FIRQB+FOQNAM1+2 


FIRQOB+FQEXT 


FIRQB+FQEXT+1 


FIRQB+FQSIZ 


FIRQOB+FQDEV 


FIRQB+FQDEVN 


Set characteristics flag bits mask. Zero indicates no 
change. A nonzero value represents the flag bits to be 
set in the characteristics flag word. The bit 
positions currently in use are: 


Bit 0 Allow <BS> for backspace (LA180) 

Bit 1 Do not process <BS> as backspace 

Bit 2 Allow 8-bit characters (LNO1) 

Bit 3 Allow nonprinting characters 

Bit 4 No fill for <FF> 

Bit 5 Allow <EOT> 

Bit 6 No <CR> required before <LF>,<VT>,<FF> (LP11) 
Bit 7 Ignore <CR> if next is <LF> (LP1l) 


Note that a value of 3 (set both bits 0 and 1) is 
illegal. All other combinations are permitted. 


Clear characteristics flag bits mask. Zero indicates 
no change. A nonzero value represents the combination 
of flag bits to be cleared. See the previous 
discussion for FIRQB+FQNAM] for an explanation of the 
bit meanings. 


Change special character flag. Zero indicates no 
change. One indicates a change to the Lineprinter 
Special Character (LPTSPC). 


If FIRQB+FQEXT is equal to one, then this byte contains 
the new Lineprinter Special Character. 


The default printer form length. Zero indicates no 
change. A nonzero value is the new default printer 
form length. The maximum value is 377. 


The device name in two ASCII characters; must be LP. 


The line printer unit number on which to perform the 
operation. 


3-318 


-UUO 
UU.CFG 
Data Returned (Set LPn: characteristics) 


Except for a possible error in byte 0 of the FIRQB, the system returns 
the following: 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
per ee ee pe ee ee ee ee ee ee eee + 


1 WLLL 0 


3 WLLL 2 


7 | case flag i default page width | 6 FQPPN 
ts current characteristics flag word | 10 FQNAMI1 
13 WLLL 12 
15 |current special char. V/YILLISLIISLILLLLLILT | 14 FQEXT 


LI VWSSSSISSISSA AA AAA AAA / 4 /\ carrent form length 16 FQSIZ 


23 LPILI LLL IL ILIITULIDLDT IL ILTLTULIDIDTIT ELD 22 


Hee nee eee eee eee eee Heer ree eee ee eee eee eee + 


25 EI EAA ENA Sa AMEE AN CA RAM MAAME 24 


33  LLLILIILIDLILILL ALT ILIDL ILL ALIAL ADA ADD TE 32 

35 WLLL 34 

37 VM 36 
FIRQB+FQPPN Current width of the LP unit specified in FIRQB+FQDEV 

and FIRQB+FQDEVN. 

FIRQB+FQPPN+1 Current value of the case flag. 
FIRQB+FQNAM1 Current value of the characteristics flag word. 
FIRQB+FQEXT+1 Current value of the special character. 


FIRQB+FQSIZ Current value of the default form length. 
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Errors (Set LPns: characteristics) 


BDNERR An attempt was made to set both bits 0 and 1 in the 
characteristics flag word. 


NODEVC An attempt was made to set characteristics of a printer 
which is not supported by the monitor, or the device 
name specified in FIRQB+FQDEV was not LP. 

Data Passed (Set System Defaults) 

FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 adds 0 
FQFUN 3 | UU. CFG (= 42) V/PAPLIPTILLILLATLALIT 2 
S ISASSIS/I1111/11//////\ sabtunction code =2 | 4 FQFIL 
7 | powerfail delay in seconds | 6 FQPPN 
11 | default time format | default date format | 10 FQNAM1 


13 | default tape density| default tape label | 12 


31 LLILILILILA UL ILT IL ELIPILTIT AVEDA ULI 30 FQDEV 
SB SSIIIIIIIISAIISAALLAS ISAS AANA SAAS S111 1171 \ 32 PQDEVN 


37 WAC ROR EA RG 36 


FIRQB+FQPPN Default powerfail delay in seconds. Zero indicates no 
change. A nonzero value represents the new default 
powerfail delay. The maximum is 454 (octal) seconds. 
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FIRQB+FQNAM1 


FIRQB+FQNAM1+1 


FIRQB+FQNAM1+2 


FIRQB+FQNAM1+3 
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Default date format. Zero indicates no change. One 
indicates NUMERIC date format. The ALPHA date format 
is indicated by 377. 


Default time format. Zero indicates no change. One 
indicates 24 hour time format. The 12 hour (AM/PM) 
time format is indicated by 377. 


Default magnetic tape label. Zero indicates no change. 
One indicates DOS magnetic tape label. The ANSI 
magnetic tape label is indicated by 377. 


Default magnetic tape density. Zero indicates no 


change. One indicates 1600 bpi. A density of 800 bpi 
is indicated by 377. 
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Data Returned (Set System Defaults) 


Mne- Octal 
monic Offset 


1 


3 


FIRQB+FQPPN 


FIRQB 


Octal 


SEEM MELE SS ARIA ELAS MELA HA 
Vad 


0 

2 

4 

6 
10 
12 
14 
16 
20 
22 
24 
26 
30 
32 
34 


36 


The number of seconds to delay of powerfail 


FIRQB+FQNAM1 Default date format. One indicates NUMERIC 
format. The ALPHA date format is indicated 


FIRQB+FQNAM1+1 Default time format. One indicates 24 hour 
format. The 12 hour (AM/PM) time format is 


by 377. 


Mne- 


Offset monic 


FOPPN 


FQNAM1 


restarts. 


date 
by 377. 


time 
indicated 


FIRQB+FQNAM1+2 Default magnetic tape label. One indicates DOS 
Magnetic tape label. The ANSI magnetic tape label is 


indicated by 377. 
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FIRQB+FQNAM1+3 Default magnetic tape density. 
A density of 800 bpi is indicated by 377. 


Errors (Set System Defaults) 


FIXERR 
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One indicates 1600 bpi. 


An attempt was made to specify a powerfail delay value 


greater than 454 (octal) seconds. 


Data Passed (Load and Remove Monitor Overlay Code) 


Mne- 


FQFUN 


Octal 
monic Offset 


1 


3 


FIRQB 


| UU.CFG (= 42) V/PISLIPLILLTTPL ILI TLT | 
Herre eee eee ee eee Hee ee ee ee ee eee eee + 


\SIISIII AIA 11 1444/4 ///\ saubtunction code =4 | 
ASSIA SSAA /414////\ 9 = load, 1 = unload | 


3-323 


Octal Mne- 
Offset monic 


0 

2 

4 FQFIL 
6 FQPPN 
10 FOQNAMI 
12 


14 
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FIRQB+FQPPN Operation flag. Zero indicates load the named overlay 
code. A one indicates unload the named code. 


FIRQB+FQNAM1 Internal overlay name in RAD50 format. These names are 
subject to change in future releases of RSTS/E. 
Presently, the following names have been defined: 


DIR Handles directory lookups 

DLN Handles delete and rename 

LIN Handles the UU.ATR SYS() call 

PFB Handles several functions used by the DCL command 
file processor 

TRM Handles the set-terminal-characteristics (UU.TRM) 
SYS() call. 

UUO Handles UU.TBl, UU.TB2, UU.TB3, UU.FCB, UU.CNV, 
UU.SYS, and UU.ERR 


Data Returned (Load and Remove Monitor Overlay Code) 

Except for a possible error in byte 0 of the FIRQB, for a load 
operation, the system returns the amount of XBUF used (in bytes) in 
FIRQB+FQPPN. The remove monitor overlay code operation does not 
return any data. 


Errors (Load and Remove Monitor Overlay Code) 


INUSE The overlay code specified is already loaded. (Load) 

NOBUFS There is not enough XBUF available to load the named 
overlay code. (Load) 

NODEVC The named overlay code is not loadable. (Load) 

NOSUCH The overlay name is invalid. (either) 

NOTMNT The overlay name is not loaded. (Remove) 
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UU.CHE (Enable/Disable Disk Caching) 


Privileges Required 


TUNE is required to enable or disable disk caching. 


Data Passed 


FIRQB 
Mne- Octal Octal 
monic Offset 
perce eee eee eee eee peer ee eee eee + 
LSASSASSIIAIISSI IIASA ASIA AAAS SASS SSSA A 111117 \ 9D 
POFUN 3 | UU.CHE. (= 23) V/////////IIIVIIIINI/\ 2 
FOSIZM 5 | cache cluster size | subfunction code | 4 
i | Uswit on €otal number of cache clusters |. % 
11 | limit on clusters for directory caching | 10 
i5-1) Apa oncciueters con wee daca caching. | 22 
15 | controls sm buffers | mode for enbl/diebl | 14 
VEEL 
SVE: 
LVL 
VEEL 
LVL 
BL IIIT 0 
83 //ILIIITIVIITLLIIT LITT LLTTLLITLLUTT D2 
85 IL/LIIIILLIIIT IIIT 
37 WLLL 36 
FIRQB+FQFIL 0 Enable directory and data caching 


1 Disable all caching 
200 Return current caching parameters 
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Mne- 


Offset monic 


FOFIL 
FQPPN 


FOQNAM1 


FQEXT 
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UU. CHE 
FIRQB+FQEXT 0 Use current setting 
1 Enable caching as specified in file open mode or 
UFD setting 
100 Cache all data transfers regardless of the file 
open mode or UFD setting 
200 Disable all caching 
FIRQB+FQEXT+1 0 Use current setting 


1 Allow use of small buffer pool (nondata caching 
option only) 
200 Do not use small buffer pool 


Data Returned 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se 5 + 
1 CE OTL 0 
i + 
3 WZ 2 
5 re Se + 
FOSIZM 5 | cache cluster size |current axehe setting| 4 FQFIL 
Se tenn rr ee eee eee + 
7 | limit on total number of cache siiseers | 6 FQPPN 
Sr tere ree eee eee eee + 
11 | limit on clusters for directory caching | 10 FQNAMI1 
re Se + 
13 | limit on clusters for user data eacheed | 12 
i Se + 
15 |controls sm. buffers |mod. for en. /disable | 14 FQEXT 
tener ee ee eee ee eee toner ee ee eee eee + 
17 | cache age | 16 FQSIZ 
SO Heer ete eee eee ee ee eee + 
21 | monitor pool | 20 FQNAM2 
Se Se + 
23 | XBUF pool | 22 FQMODE 
tere ener ee eee eee eee Se + 
25 | number of directory tags | 24 FQFLAG 
Hern ee ee eee eee eee Here en ee ee eee eee + 
27 | number of data tags | 26 FQPFLG 
Sr Se + 
31 | number of invalid tags | 30 FQDEV 
Se Sel + 
33 |SSAAASSIIIIAIIAIAIAIIIAAAA AAAS AAAS AAAS 32 
5 Se + 
BS ISSSASSIIIIASIIIAS AAAI IA IAAI AAA AAAS AAA 1174 \ 34 
teen ee ee eee eee eee eee terre eee ee ee eee + 
37 OE LOL eg 36 


3-326 


FIRQB+FQFIL 


FIRQOB+FQSIZ 


FIRQB+FQNAM2 


FIRQB+FQMODE 


FIRQB+FQFLAG 


FIRQB+FQPFLG 


FIRQB+FQDEV 


Errors 
ERRERR 
INUSE 


NOROOM 


NOTAVL 


PRVIOL 


-UU0 
UU. CHE 
Current cache settings and available options: 
0 Cache disabled, user data caching is not available 
1 Cache enabled, user data caching is not available 
200 Cache disabled, user data caching is available 


201 Cache enabled, user data caching is available 


The time in seconds that an unused cache can be kept in 
memory. . 


The amount of small buffers used for caching (in units 
of cache clusters). 


The amount of XBUF used for caching (in units of cache 
clusters). 


The number of cache clusters in XBUF that are used for 
directory caching. This value is valid only if data 
caching is included. 

The number of cache clusters in XBUF that are used for 
data caching. This value is valid only if data caching 
is included. 


The number of invalid cache clusters in XBUF. This 
value is valid only if data caching is included. 


Caching not enabled during system generation. 
All of the clusters allotted to the cache are in use. 


Not enough XBUF space to enable data caching. System 
manager must allocate at least 2K words. 


Tried to change cluster size while cached file disk 
transfer in progress; retry. 


Current user does not have TUNE privilege. 
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-UU0 
UU. CHK 
Data Returned - Check File Access Rights 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 TEAM AIC MESLEAE ALS REE A AMGELLED 0 
3 PPLLSPPLPLTLSPPSLPPLLLLSPLSSS PATS PAPAL P STD 2 


5 | access flags | 4 FQERNO 


11 Vdd 10 


FIRQB+FQERNO The bits are set to indicate access rights as follows: 


Bit 0 Owner rights are granted 

Bit 1 Read access is not allowed 

Bit 2 Write access is not allowed 

Bit 5 Execute access is not allowed 

Bit 6 Accounting rights are granted or the PPN is the 
Same as that of the caller. 

Bit 7 Accounting rights are granted 


Errors 


No errors are possible with this subfunction of UU.CHK. 


Data Passed - Convert Privilege Name to Mask 


Mne- 


FOQFUN 


Octal 
monic Offset 


1 


3 


FIRQB 
Here eee ee ee eee penne ee ee eee eee + 
Vad 
IIIA ISS IA / 1/11 ///\ saotaunction code =1 | 


privilege name as a 6-character 


+ 
| | 
+ + 
| uppercase ASCII string or "ALL" | 
+ + 
| padded roa NULLS | 

+ 
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Octal 
Offset monic 


0 


2 


- UUO 
UU. CHK 


Mne- 


FQFIL 


FOQNAM1 


-UU0 
UU. CHK 
Data Returned - Convert Privilege Name to Mask 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 Pe ee 0 
3 Vdd 2 
)  PLILILLIPLILILI IIIT error flag | 4 FQERNO 
7 CAAA ALAA AREAS SAA SARC 6 


Bere le mask 10 FQNAMI1 


(4 words) 12 
14 
16 
2 eA hhh 
23 GMS HERS ELA Sl ball tal AAI GIA ALE GA AHA 22 
25 Veeaddaaaaadidiida 24 
27 Vda 26 
31 I LLILILILI ITIL IL ILILA LDL IL ILILA EDAD IL TL ELE 30 
33 Wea 32 
35 Veda 34 


37 Veda 36 


FIRQB+FQERNO If the passed privilege name was not ALL: 


zero means the current job has the named 
privilege. 


One means the current job does not. 
If ALL was passed: 
zero means the current job has all privileges. 


One means the current job does not. 
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' FIRQB+FOQNAM1 If the passed privilege name was not ALL, 


Errors 


NOSUCH 


-UU0 
UU.CHK 


the bit 


corresponding to the named privilege is set. All other 


bits are clear. 


If ALL was passed, all privilege bits that currently 
have meaning are set. All other bits are clear. 


The name passed in FIRQB+FQNAM1 is not a valid 


privilege name. 


Data Passed - Convert. Privilege Mask to Name 


Mne- Octal 
monic Offset 


FQFUN 


1 


3 


FIRQB 


Se Se + 


WAAL hhh 
| UU.CHK (= 40) WAAL hhh 
AIIIIISI1S1111///////\ sabtanction code =2 | 


privilege mask 


(4 words) 
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Octal Mne- 
Offset monic 


0 
2 
4 FQFIL 
6 
10 FQNAM1 
12 
14 
16 
20 
22 
24 
26 
30 
32 
34 


36 
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Data Returned - Convert Privilege Mask to Name 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre eee ee eee ee ee eee tere er ee ee ee eee eee eee + 
LYSAAIIIIIIIIIITAAAIA AIA A SAA AAA AAA AAAS \ 9 
t-- ee ree eee tee eee tere rr ree er ee eee eee eee + 
SISSSISASLSSTIAS ALAA STAAL AA IA AAT A TAA EASA LA 7 |. 
terre rete ee ee eee eee Se + 
5 TAIN Mae Ai fa AA MU RELEASE EADIE 4 
Se ee + 
7 Vdd 6 
Se + 
11 | | 10 FQNAM] 
+ + 
13 | privilege mask | 12 
+ + 
LS>< (4 words) | 14 
+ + 
i? 4 | 16 
Se Se + 
21 | | 20 FQNAM2 
+ 6-character uppercase ASCII string + 
23 | | 22 
+ padded with NULLS + 
Z25..«| | 24 
Sr 5 + 
ZT WSAASASIIAIAIIAAAAA AAAI AAA AAA AAA AAA AAA AAAS 71 28 
Se Sr + 
BL YSSASSSISIIIAIIIASAI AAAI AAAS AAAS AAA AAAS AAA 17 \ 30 
Se Se + 
33 ee RE Ot Oe 32 
i is + 
35 Uda 34 
i ee is + 
37 LLLLLPTLLALLLTLYLLPILLALYLPPADP ADIL DALLA 36 
Sa torre eee eee ee eee + 
FIRQB+FQNAM1] The privilege mask is the same as that passed except 
that any undefined bits and the bit corresponding to 
the name in FQNAM2 is turned off. As a result, a 
subsequent call using the returned mask would return 
the name of the next privilege. This makes it easy to 
translate an entire mask by repeated calls to this 
function. 
FIRQB+FQNAM2 The name of the privilege corresponding to the first 


set bit in the mask. 
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-UUO 
UU.CHK 


Errors 


NOSUCH The privilege mask in FIRQB+FQNAM] is zero or specifies 
only unassigned privilege bits. 
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-UUO 
UU.CHU 


UU.CHU (Set Password, Change Password/Quota/Expiration Date, Disable 
Terminal,Kill Job) 
This directive has five subfunctions: 

o Set Long Password 


o Change Quotas (V9.0 format), Expiration Date, and Short 
Password 


o Change Quotas (pre-v9.0 format), Expiration Date, and Short 
Password 


o Disable Terminal 
o Kill Job 
Privileges Required (Set Long Password) 


GACNT or WACNT are required to set passwords. 
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-UU0 


UU.CHU 
Data Passed (Set Long Password) 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tere eee ee ee eee eee eee teen ee eee ee eee eee eee + 
de SALAS SLIASSATTAAIAS IAAI AAA LITA ASA AAAS SII FLT | 
Se tener eee ee eee eee eee eee + 
FOFUN 3 | UU.CHU (=10) VAAL hhh 
Se 5 + 
DS LSASSSIISIIIIIIAISAS SAIN AAAS SSAA AAAS AAA PQPILD 
Sr terre re eee eee ee eee + 
7 | project number | programmer number | 6 FQPPN 
Sa toner ree ee eee eee eee ee + 
11 | | 10 FQNAM1 
+ + 
13 | | 12 
+ + 
LS. | 14 
+ | + 
17 | long password | 16 
+ + 
21 | (14 bytes, padded with NULLs) | 20 
+ + 
23 | | 22 
+ + 
25 | | 24 
fen ee ee ee ee eee eee eee eee + 
27 LOAN REDE AKM AAA EEE EE KE AGAEE RELAIS 26 
31 VSYILSLLSTLPYILPISLLALPTTPLALPAPSP APTS ITD 30 
terre ee ee eee ee eee t--- eee ee ee ee eee eee + 
33 |SSAIIAIIIIIIAAAAAAA AAA AA AAA AAA AAA AAA AAA 32 
Horn eee ee ee ee ee eee ee tenn ee ee eee ee eee eee + 
35° |, (must be 0) | (must be 377) | 34 FQCLUS 
a tenner eee ee eee ee ee eee + 
37 SEU AEE A MAR EEL EAS EAL EGE RAHAA AAA EAA Ms 36 
Sn + 


FIROB+FONAMIL Yf the first byte is zero, the password information is 
deleted (this turns the account into a nonuser 
account). 


If password lookup is enabled using CREATE/ACCOUNT or 
SET PASSWORD then the password must consist of six 
uppercase letters or numbers. Otherwise, it can 
contain any character except the question mark (?). 
The monitor also enforces a minimum password length of 
six characters. 


S=337 


-UU0 
UU.CHU 


Note 
In this subfunction, the PPN is specified in a 
different place than in the "Change Short 
Password/Quota" subfunctions where the PPN is 


specified in FQNAM1. 


Privileges Required (Change Short Password, V9.0 Quotas, or Expiration 
Date) 


GACNT or WACNT are required to set passwords, quotas, or expiration 
date. 


Data Passed (Change Short Password, V9.0 Quotas, or Expiration Date) 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Sa tener re ee ee eee + 
LYSAAISAIIIIIIAAA AAAS AAAS AAAS AAAS A114 9 
Se Sr + 
FQFUN 3 | UU.CHU (=10) WAAL he 
Se terre eee ee ee eee ee ee eee + 
a flag byte | detached job quota | 4 FOQFIL 
terre er er eee eee ee eee terre ee eee ee eee eee + 
7 ee ee ea 6 
Se ea + 
a -{] project number 1 programmer number | 10 FQNAM1 
Sl tee eee ee ee eee eee eee + 
13 | new password in RAD50 format | 12 
+ (2 words) + 
15 | (zero if no change) | 14 
tener eee ee ee ee eee eee Here eee ee eee eee + 
17 | logged-out quota (LSB) | 16 FQSIZ 
teen ee ee ee eee ee eee tere ne ee eee eee eee + 
21 | account expiration date | 20 FQBUFL 
tener eee eee eee eee eee terre er ee eee eee ee eee + 
23 | logged-in quota (LSB) | 22 FQMODE 
tee eee ee ee ee eee eee terete eee ee ee eee ee eee + 
25 |logged-out quota(MSB)| logged-in quota(MSB)| 24 FQFLAG 
| tenn ee ee eee eee + 
27 |SAISSISSSIS1111/1///7//\ =377 to change quota| 26 FQPFLG 
5 el tener ee ee ee ee eee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
Sl Sl + 
33 |#0, unit number real | device unit number | 32 FQDEVN 
Sl Sr + 
35 | (must be zero) | 34 FQCLUS 
toe - ree eee ee ee ee ee eee ter rc ee ee ee ee ee eee + 
BST LSASAISIIIIIIAI ASAE AAA AAA AAA AA AAAS A171 | 36 
Se tent eee eee eee ee eee ee + 


-UU0 
UU.CHU 


FIRQB+FQFIL The number of detached jobs allowed under this account. 


FIRQB+FQFIL+1 Flag byte. Zero means change the disk quotas using the 
pre-v9.0 format (see the next subfunction). Nonzero 
means the following: 


Bit 0 Change logged-out quota 

Bit 1 Change logged-in quota 

Bit 2 Reserved 

Bit 3 Change detached job quota 

Bit 4 Reserved 

Bit 5 Reserved 

Bit 6 Reserved 

Bit 7 Change disk quotas using V9.0 format 
FIRQB+FQSIZ The LSB of the logged-out quota. 


FIRQB+FQBUFL Zero means no change. Nonzero means this value is the 
new expiration date. 


FIRQB+FQMODE The LSB of the logged-in quota. 
FIRQB+FQFLAG The MSB of the logged-in quota. 
FIRQB+FQFLAG+1]1 The MSB of the logged-out quota. 


Privileges Required (Change Short Password, pre-V9.0 Quotas or 
Expiration Date) 


GACNT or WACNT are required to set passwords, quotas, or expiration 
date. 
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Data Passed (Change Short Password, pre-V9.0 Quotas or Expiration 
Date) 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se tee eee eee eee ee eee eee + 
1 EO 0 
Se ee es + 
FQFUN 3 | UU.CHU (=10) WLLL 2 
ee ee er eae 
9 SP LPLPLSLILALSALPALLLAPAAPILPISTLITI ISD ID 4 
a ee + 
7 TEER ARE SIAL G AL ASEM EGE GS ELNLAL AMAA Ah 6 
Sr ie + 
Ld. || project number 1 programmer number | 10 FQNAMI1 
re tee eee eee eee ee eee eee + 
or new password in RAD50 format | 12 
+ (2 words) + 
152.1] (zero if no change) | 14 
Here eee ree ee ee eee Henne eee eee ee eee eee + 
17 | number of blocks for quota; 0 = unlimited | 16 FQSIZ 
Se terre ee eee ee ee ee eee eee + 
21 | account expiration date | 20 FQBUFL 
Sa Se + 
23 Oe 22 
Se ee as + 
25 Veeaaaddaaadaadiaiidida 24 
Se + 
27 Wyn =377 to change quota| 26 FQPFLG 
tenn eee ee ee eee eee eee tenn ree eee eee eee ee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
Si Se + 
33 |#0, unit number real | device unit number | 32 FQDEVN 
t--- ee ee eee pete eee 5 + 
35 | (must be zero) | 34 FQCLUS 
5 Se + 
CN EU AAA 
toner ee eee ee eee ee eee tenn eee ee ee eee eee + 


FIRQB+FQBUFL Zero means no change. Nonzero means this value is the 
new expiration date. 


Privileges Required (Disable Terminal) 


HWCTL is required to disable a terminal. 
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Data Passed (Disable Terminal) 


Mne- Octal 
monic Offset 


1 


FOQFUN 3 


FIRQB 


Udi 
| UU.CHU (=10) VALILILILILILILILILIL 


Hee ee ee eee eee eee Herre eee ee eee ee eee + 


WALL keyboard number | 


I LPILILILIL LILI ILTLT ELIT AD DAD ELAD LIL ILD 


Her errr Her eter ee ee eee eee + 


NET TCCL COOLED TROLL EL LER OLO TO CT CCLCL EE | 


Privileges Required (Kill Job) 


JOBCTL is 


required to kill a job. 
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Octal 
Offset monic 
ae peer cee ew eee eee eee eee + 


0 


-UU0 


UU.CHU 


Mne- 


FQFIL 


FQCLUS 


-UU0 
UU. CHU 


Data Passed (Kill Job) 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 NRE IEE REE ASDA ESM GAL EG AAMC 0 

FQFUN 3 | UU.CHU (=10) WZ 2 


5 PLTITLILILILILILTIT | job number to kill | 4 FQFIL 


35). (must = 377) i (must be zero) | 34 FQCLUS 


FIRQB+FQFIL Specify zero to kill current job. 
Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.CHU 
subfunction does not return any meaningful data. 
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-UU0 


UU.CHU 
Errors 
BADFUO The system returns this error for one of the following: 
o Change password/quota. Device specified is not a 
disk. 
o Kill job. Job number is out of range or the job 
does not exist. 
o Disable terminal. The keyboard number is: 
- Greater than number of keyboards on system 
- A pseudo keyboard 
- Currently opened or allocated by a job 
BADNAM For change password/quota. Password is too short, or 
too long, or contains illegal characters. 
NOSUCH For change password/quota. Account not present on disk 
specified. 
NODEVC For change password/quota. Device specified is not on 


the system. 
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UU.CNV (Date and Time Conversion) 


Privileges 


None 


Required 


Data Passed 


Mne- Octal 


monic Offset 


37 


Octal Mne- 


|internal form date (see .DATE);0 = current | 


Offset monic 


0 


4 FQOFIL 


6 FQPPN 


22 FQMODE 


24 FQFLAG 


FIRQB+FQFIL Zero means use system default format. A value less 
than zero means use alphabetic date format. A value 
greater than zero means use ISO numeric date format. 


FIRQB+FQFLAG Zero means use system default format. A value less 


than zero means use 12-hour time format. 


A value 


greater than zero means use 24-hour time format. 
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Data Returned 


Mne- Octal 
monic Offset 


Errors 


1 
3 
5 


FIRQB 

Octal 
es tere eee eee ee ee eee ee eee + 
ee 0 
pn nr ee ee ee pe ee ee ee ee ee eee eee + 
Wyn job number * 2 | 2 
Se t-- ee ee ee ee eee eee eee + 
| (Same as data passed) | 4 
terre ee ee ee ee ee ee eee terre re ee ee eee eee + 
| {same as data passed) | 6 
tee eee ee ee ee ee ee ee eee tee eee ee ee ee ee eee eee + 
| | 10 
+ + 
| date string (padded | 12 
+ . + 
| at end with NULLS) | 14 
+ + 
| dd-mmm-yy or yy.mm.dd | 16 
+ + 
| | 20 
tee eee ee eee ee ee ee eee terre eee ee eee ee ee ee eee + 
| (same as data passed) | 22 
terre eee eee eee ee ee eee tee eee ee ee ee eee eee eee + 
| (same as data passed) | 24 
tee ee eee eee ee eee eee tonne ee ee ee ee ee eee eee + 
| | 26 
+ time string (padded + 
| | 30 
+ at end with NULLs) + 
| | 32 
+ hh:mm xm or hh:mm + 
| | 34 
Her ee ee pe ee ee ee ee ee ee eee + 
VZaaaaadaaaaaiaidida 36 
terre ree ee ee eee eee ee teen ee ee eee ee eee eee eee 


- UU0 
UU.CNV 


Mne- 


Offset monic 


FQJOB 
FOFIL 
FOPPN 


FOQNAM1 


FQMODE 
FQFLAG 


FOPFLG 


No errors are possible; however, if the date or time passed is 
illegal, 


random output is generated. 
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UU.DAL (Deallocate All Devices) 


Privileges Required 


None 


Data Passed 


Mne- Octal 
monic Offset 


1 
FOFUN 3 
5 
7 
ll 
13 
15 
17 
21 
23 
25 
27 
31 
33 
35 


37 


I LPLLILILILILT IL IL IL ELT EDEL ELI ILTLT LDL IDE 


pete ee ee eee eee eee teen e eee eee ee eee eee + 


AAA hhh 


Data Returned 


The UU.DAL subfunction does not return any data. 


Errors 


No errors are possible with the UU.DAL subfunction. 
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Octal 
Offset 


0 


2 


Mne- 
monic 


-UUO 
UU.DAT 
UU.DAT (Change System Date/Time) 
Privileges Required 
DATES is required to change system date or time. 
Data Passed | 
Mne- Octal | Octal Mne- 
monic Offset Offset monic 
1 UZ 0 
FQFUN 3 ' UU.DAT (= -16) VMI 2 


3 / new current date | 4 FQFIL 


ro new current time | 6 FQPPN 


15 LPILILTELILILTLT ELI LDA LDL AL TDT IDL ILTLD 14 


terre eee eee eee ee ee eee Herne ee eee eee ee eee + 


LV VSSSSSSSAIIAIIIAI SSSA IANA A SAAS A SATS TSS 1 1771 \ 16 


37 WLLL 36 
FIRQB+FOQFIL The system internal format for date is: 
{[(year - 1970) * 1000] + day-within-year 
FIRQB+FQPPN Time is expressed as minutes until midnight, where 1440 


equals midnight. 
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UU.DAT 
Note 
A value of zero in either of these fields means no 


change is to be made. See the .DATE directive for a 
discussion of these formats. 


Data Returned 


The UU.DAT subfunction does not return any data. 


Errors 


PRVIOL Dates prior to 11-Jan-85 cannot be set. 
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UU.DEA (Deallocate Device) 


Privileges Required 


None 


Data Passed 


Mne- Octal 
monic Offset 


1 


FOFUN 3 


tere eee ee eee ee eee Here ree eee eee eee + 


Vda 
| UU.DEA (= 13) VALILILILILILILT ITIL 


i Se + 


Vda 


{#0, unit number real | device unit number | 


Data Returned 


Except for a possible error in byte 0 of the FIRQB, the 
subfunction does not return any meaningful data. 
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Octal Mne- 
Offset monic 


0 


2 


24 
26 
30 FQDEV 
32 FQDEVN 
34 


36 


UU.DEA 


-UU0 
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Errors 


NODEVC The device or device type in the two words at 
FIRQB+FQDEV is not on the system. 
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'UU.DET (Detach) 


Privileges Required 

None required to detach the caller’s job (depending on quotas). 

JOBCTL is required to detach another job. EXQTA is required to 

suppress the detached job quota check. 

Data Passed 

Mne- Octal Octal Mne- 

monic Offset Offset monic 
LUSSSASIAIISIIIIII AIA AAAS A AAAS AAA AAAS 117 \ 9% 

FQFUN 3 | UU.DET (= 7) WVAALAAAAL he 


tee ee ee ee ee ee ee ee eee Se + 


=) WALA ECT LET EL EET ED ORS flag & job no. | 4 FQFIL 


tener er eee ee eee eee terre ee eee eee eee eee + 


Un VAAL hhh 
11 IEE II GENER AEA EE EE DG GEAAE AAR 10 


37 Vdd 36 
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FIRQB+FQFIL Flag byte as follows: 


Bits 0-6 equals the job number to detach. If zero, 
detach calling job. 


Bit 7 clear means do not close terminal channels or 
deallocate terminal. Bit 7 set means close all 
channels on which terminal is open and deallocate 
terminal, if allocated. 


Note 


If a job running under control of an indirect command 
file is detached using the UU.DET directive, a new 
job is created at that terminal, logged in to the 
same account, and execution of the command file 
continues with the new job. The detached job retains 
its job number, while the command file resumes under 
a different job number. 


Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.DET 
subfunction does not return any meaningful data. 


Errors 
BADFUO The current job is already detached. 
QUOTA The detached job quota for the account has been 


reached. 
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UU.DIE (System Shutdown) 


Privileges Required 


SHUTUP privilege is required to shut down the system. 


Data Passed 


Mne- Octal 
monic Offset 


i 


FOFUN 3 


Se Her eee eee eee ee eee + 


NOAA MEA ALK RAE LANAESA KGAA AAA E AMAR AD 


Data Returned 


Except for a possible error in byte 0 of the FIRQB, the 
subfunction does not return any meaningful data. 
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Octal Mne- 
Offset monic 


0 


2 


UU.DIE 


-UUO 
UU.DIE 


-UU0 
UU.DIE 
Errors 
BADFUO One of these conditions has not been met: 
o Only one job can be running 
o Logins must be disabled 
o No disks except the system disk can be mounted 


o No files can be open on the system disk 
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UU.DIR (Directory Lookup) 
Privileges Required 
If the device is restricted, DEVICE privilege is required to perform 
directory or disk lookup on the caller’s account. File read or 
execute access (by protection code, GACNT or WACNT privileges) is 
required to perform disk directory lookup on another account. 
Data Passed - Directory Lookup on Index 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
L|SSASAIISALI SAIS AAA AAA AA AA AAAS A171 \ 9 
FQFUN 3 | UU.DIR (= 17) WVAALALL AAA 
54 index of file to read | 4 FQFIL 
7 | project number | programmer number | 6 FQPPN 
11 ee age 10 
13 Vad 12 
15 Vda 14 
17 Vda 16 
21 Vdd 20 
23 | marked-for- “delete flag | 22 FQMODE 
25 Uda 24 
27 Uda 26 
31 | device name (2 neces characters) | 30 FQDEV 
33 |40, unit number real | device unit number | 32 FQDEVN 
35 Oe eee, 34 
37 Vda 36 
FIRQB+FQPPN Specifies the PPN to look up. For disks, the PPN 
defaults to the caller’s PPN. For DOS format magnetic 
tape; a zero in FIRQB+FQPPN means look up files 


regardless of PPN, a nonzero means only files with that 
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-UUO 
UU.DIR 


PPN are returned. For ANSI magnetic tape and DECtape, 
RSTS/E ignores FIRQB+FQPPN. 


FIRQB+FQMODE Marked-for-delete flag. 


Bit 14 set causes UU.DIR to return information about 
marked-for-delete files. 


Data Returned - Directory Lookup on Index 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre eee ee eee ee eee eee Herre ere ee eee eee eee + 
1 CO EADIE AAA LALE SURES AREA HEAL G ial 0 
Se + 
3 WEE current job no. * 2 | 2 FQUOB 
tere cen ree ee eee ee eee tener eee eee eee + 
5: sf (same as data passed) | 4 FQFIL 
tee ee ee eee eee eee ee eee terete ee ee ee ee eee eee + 
ae i project number | pEpgsemer number | 6 FQPPN 
per nee ee ee ee eee eee terre tee eee eee eee eee + 
ll | file name in RAD50 fovnae, | 10 FQNAMI 
+ (2 words) + 
13 | | 12 
terre ree ee ee ee ee eee Here ee re ee ee eee eee + 
15 | file type in RAD50 format (1 wera) . | 14 FQEXT 
terre eee eee ee eee eee teeter eee eee eee eee + 
17 | LSB of file size | 16 FQSIZ 
ten en eee ee eee ee eee eee torte eee eee ee eee + 
21 | MSB of file size | protection code | 20 FQNAM2 
teen een ee eee ee eee ee eee ference eee eee ee eee + 
23 | date of last access | 22 FQMODE 
Se tent nee eee ee eee ee eee + 
25 | date of creation | 24 FOFLAG 
terre eee ee eee cree Herre eee eee eee eee + 
27 | time of creation | 26 FQPFLG 
5 terre ee ee eee eee + 
31 | (same as data passed) | 30 FQDEV 
St Hones + 
33 | (same as data passed) | 32 FQDEVN 
Sl Sr + 
35°] file cluster size | 34 FQCLUS 
Sr Si + 
37° ‘| USTAT byte Ino. entries réturned | 36 FQNENT 
te - ee ee ee ee eee ee ee eee terre ee eee ee ee ee ee eee + 


FIRQB+FQMODE System internal format for date is: 
FIROB+FQFLAG 


[(year - 1970) * 1000] + day-within-year 
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- FIRQB+FQPFLG 


- UU0 
UU.DIR 


Time is returned as minutes before midnight, where 1440 
equals midnight. For look up on DOS format magnetic 
tape, this field contains the PPN of the file. 


Note 


See the .DATE directive for a discussion of the date 
and time formats. 


FIRQB+FQNENT+1 The USTAT byte from the UFD Name entry. This byte 


Errors 


BADDIR 


DEVNFS 


NOSUCH 


XXXXXX 


contains the following internal flag information (for 
disk only): 


Bit Meaning When Set 
1 File is placed 
2 Some job has write access now 
3 File is open in update mode 
4 File is contiguous; no extend allowed 
5 No delete or rename allowed 
7 File is marked for deletion 


The directory structure is invalid. For magnetic tape, 
this error usually indicates you are reading an ANSI 
format tape in DOS mode, or a DOS format tape in ANSI 
mode. 


The device specified is non-file-structured. 


The account specified does not exist on the device or 
no more files exist on the account. 


The call also returns device-dependent errors such as 
NOTMNT (disk pack not mounted). 
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Data Passed ~- Special Magnetic Tape Directory Lookup 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herre eee eee ferret ee ee ee eee eee + 
1 PLLLILLLLLLLALLLLLLELA LALLA ALAA A ALAA | 0 
Herc ete eee ee ee eee eee tener eee eee eee ee eee + 
FQFUN 3 | UU.DIR (= 17) WALA 
Hone ne ee eee eee tee eer eee eee eee eee eee + 
5 | index of file to read | 4 FQFIL 
Herter ree eee eee eee pene er ete eee eee + 
7-4 (= 177777 for aeons tape lookup) | 6 FQPPN 
ee ee ee ee + 
11 SP PLLPILLLALL TLL ALLL AL PLEPAPSATPAAPDAPPALE 10 
Harter eee ee eee eee eee tere eee eee eee ee ee eee + 
13 OE ELL 12 
Se ee + 
15 PP PLLLILLLLSTILLALLL IP PIPL AEST TESA TPPAT LE 14 
be ee eee ee eee eee eee tere eee ee eee ee eee eee + 
LT |SSAAIAIAIAIA AAAI AAAS AAA AAA AAA AAA AAS AAA \ X68 
tere ree eee ee ee ee eee eee terre ee eee ee ee eee eee + 
21 PEELS AI MALE A AAAS AMA 20 
Se + 
23 Vdd 22 
Si So + 
25 A PLLLIPYLPLIPLLLLALILPPLPTTPLTPP TPP LDP TDS 24 
tern eee eee ee eee eee tere eee ee ee ee ee eee eee + 
27 YSSASAAIAIASAIAAAAAA AAA AAA AAA AAA AAAS AA AAA \ 28 
terre eee ee eee ee ee eee tere eee eee ee ee eee ee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
Herter ee ee eee ee eee tenn eee ee eee eee eee eee + 
33 | 40, unit number real| device unit number | 32 FQDEVN 
tere ee ee eee ee eee ee eee tere ee ee eee ee ee ee eee + 
85 |SIASAAIIAIAIAAAAAA IAA AAAS AAA AAA AAA AA AAAS \ 34 
a s tere eee eee ee ee ee ee eee + 
B87 \SAASAALAIAIAIAAAIA AAAS AAA AAA AAA AAA AAAS 38 
Herne ee ee ee eee eee terre eee ee ee ee ee eee eee + 
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UU.DIR 
Data Returned - Special Magnetic Tape Directory Lookup 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
pene n ree eee eee ee eee Herne ee ee ee eee + 
1 UIE ALL ARICA Ah SEEM 0 
i i ee ie + 
3 WZ current job no. * 2 | 2 FQJOB 
me ee eee eee eee tenn ree ee ee ee ee et 
5 i (same as data passed) | 4 FQFIL 
5 Sr + 
7 | (same as data passed) | 6 FQPPN 
tere ner ee ee ee ee ee eee terre ee ee eee ee eee + 
ll | file name in RAD50 format | 10 FQNAM1 
+ (2 words) + 
13 | | 12 
Sl Se + 
15 | file type in aE? format (1 word) | 14 FQEXT 
Sr tee - eee eee ee ee ee eee eee + 
17 Zed 16 
i + 
21 Wn protection code | 20 FQNAM2 
Se Se + 
23 | date of creation | 22 FQMODE 
Se terre ee ee er ee eee ee eee + 
25 Oe ILE 24 
Sn as + 
FQPROT 27 | project number H programmer number | 26 FQPFLG 
Se tee ee ee ee ee ee ee eee eee + 
31 | (same as data passed) | 30 FQDEV 
Henne eee eee ee eee eee eee tere eee ee ee ee eee ee eee + 
33° |] (same as data passed) | 32 FQDEVN 
teen eee ee eee eee eee eee te -- eee er ee ee ee eee ee eee + 
35 UZ deeaaaaaaidddiidia 34 
Se + 
37 DELI EI ae entries returned | 36 FQNENT 
tenner ee eee ee ee ee eee tee rer ee ee ee ee eee eee + 


FIRQB+FQMODE System internal format for date is: 


[(year - 1970) * 1000) + day-within-year 
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Errors 


BADDIR 


NOSUCH 


DEVNFS 


This error usually indicates you are reading an ANSI 
format tape in DOS mode, or a DOS format tape in ANSI 
mode. 

No more files exist on the tape. 


The device specified in the two words at FIRQB+FQDEVN 
is either non-file-structured or not a magnetic tape. 
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UU.DLU (Delete User Account) 


Privileges Required 


GACNT or WACNT is required to delete a user account. 


Data Passed 


Mne- 


FQOFUN 


Octal 
monic Offset 


ui 


3 


| project number H programmer number | 


Herne ee ee ee eee eee eee Herre eee eee ee eee eee + 


AAA hhh hhh 


I LPIPILILLIL ILE ILILILP UDELL ILI DT LIL IL ILD 


Herne eee ee eee ee eee tener ee eee eee ee ee ee eee + 


Oe 


| #0, ie number real| device unit number | 
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Octal 
Offset monic 


0 
2 
4 
6 


10 


24 
26 
30 
32 
34 
36 


- UUO 
UU.DLU 


Mne- 


FQNAMI 


FQDEV 


FQDEVN 


-UUO 
UU.DLU 


Data Returned 


Except for a possible error in byte 0 of the FIRQB, 
subfunction does not return any meaningful data. 


Errors 


DEVNFS 


FIEXST 


INUSE 


NOSUCH 


PRVIOL 


Device is not disk or is a disk open 
non-file-structured mode. 


The account contains files. 


A user is currently logged in to the 
account. 


The specified account does not exist. 


Account specified is either [0,0] or 
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the UU.DLU 


in 


system under the 


[0,1]. 


' UU.DMP (Snap Shot Dump) 


Privileges Required 


SYSIO 


is required to perform a snap shot dump. 


Data Passed 


Mne- 


monic Offset 


FQOFUN 


Octal 


l 


3 


Octal 
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Mne- 
Offset monic 


- UUO 
UU.DMP 


- UUO 
UU.DMP 


Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.DMP 
subfunction of .UUO does not return any meaningful data. 


Errors 

BADFUO A user without SYSIO privilege attempted to execute 
this call. 

NOSUCH The call tried to write data to the file CRASH.SYS, but 
crash dump was not enabled. This error occurs if 
RSTS/E tries to allocate a crash dump file during 
system start-up but could not due to lack of disk 
Space. 

XXXXXX The call also returns device-dependent errors such as 


HNGDEV or NOTMNT. 
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, UU.ERR (Return Error Messages) 


Privileges Required 


None 


Data Passed 


Mne- Octal 
monic Offset 


1 


FOFUN 3 


I LPLPILILELILILILLLT ILIV IL ADIL ILI IL IL TLD D 


pone eee eee eee eee eee Hore eee eee eee eee + 


ee PO UE 
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Octal Mne- 
Offset monic 


0 


4 FQERNO 


10 


- UU0 
UU.ERR 


Data Returned 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre ee ee ee eee eee ee eee tee ee ee eee ee ee ee eee eee + 
1 ee 0 
i + 
FQFUN 3 |KB*2;1's comp= sdeeeny | current job no. * 2 | 2 FQJOB 
tence re eee ee eee eee eee t+--- 2 -- eee ee ee eee eee + 
5 | | 4 FQERNO 
+ + 
7 | | 6 
+ + 
11 | | 10 
+ + 
L314 error message -- padded with NULLS | 12 
+ + 
15. | to 28. characters (ASCII format) | 14 
+ + 
17 | | 16 
+ + 
aL >| | 20 
+ + 
23° | | 22 
+ + 
25 | | 24 
+ + 
27 (| | 26 
+ + 
31 | | 30 
+ + 
33 | | 32 
+ + 
35 | | 34 
+ + 
37 | | 36 
ter ener eee ee ee ee eee eee tree eee ee eee eee ee ee eee + 


Errors 


No errors are possible with the UU.ERR subfunction. 
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UU.FCB (Get Open Channel Statistics: WCB/DDB/FCB) 


The WCB is the Window Control Block for the file system. 
the Device Data Block for nondisk devices. 
Control Block for the file system. 


- UU0 
UU.FCB 


The DDB is 


The FCB is the File 
Note that the WCB, DDB, and FCB 


are internal RSTS/E structures that are subject to change at any time. 


Privileges Required 


None 


Data Passed 


Mne- Octal 
monic Offset 


1 
FOFUN 3 


FQSIZM 5 


35 


37 


| UU.FCB (=10) WALA hhh 


Si Herr ee ee ee ee eee + 


| sineede. = 0 or l |WCB,DDB,or FCB ch.no.| 


Octal 
Offset monic 


0 


2 


36 


Mne- 


FQFIL 


FIRQOB+FQSIZM Zero returns WCB or DDB information. One returns FCB 


information. 
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Data Returned (for subcode = 0) 
FIRQB 
Mne- Octal Octal 
monic Offset 
Here ee ee eee ee eee perenne eee eee ee eee + 
Oe ee 
3 VYALILTIPILTISTILILTT current job no. * 2 | 2 
sj word 1 of either the WCB or DDB. i 4 
7) word 2 of either the WCB or DDB. ic 
a word 3 of either the WCB or DDB. | 10 
3} word 4 of either the WCB or DDB. | 12 
Ii} word 5 of either the WCB or DDB. | ud 
7, word 6 of either the WCB or DDB. | ae 
ai word 7 of either the WCB or DDB. | 20 
23) word 8 of either the WCB or DDB. | 22 
2) word 9 of either the WCB or DDB. | 24 
27 word 10 of either the WCB or DDB. | 26 
oi word 11 of either the WCB or DDB. | 30 
3] word 12 of either the WCB or DDB. | 32 
3]! word 13 of either the WCB or DDB. | 34 
a7] word 14 of either the WCB or DDB. | 36 
Se terete eee ee eee eee ee + 
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Mne- 


Offset monic 


FQJOB 
FOFIL 
FOQPPN 


FONAM1 


FOQEXT 
FQSIZ 
FQBUFL 
FOQMODE 
FOFLAG 
FOPFLG 
FQDEV 
FQDEVN 
FQCLUS 


FONENT 


-UU0 
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Data Returned (for subcode = 1) 

Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 IEA GEA EE EEE EASA R Le RA 0 

3 LPILILIITILILILILS I current job no. * 2 | 2 FQJOB 

FQSIZM 5 pues w/file open rr |users w/file open nrr| 4 FQFIL 
7 | MSB of file size | Status byte | 6 FQPPN 
7s i LSB of file size SO | 10 FONAM: 
13 VW Laaddaadaaadaia 12 
15 VILLI 14 
17 LPILTILILTILILILLILILLILILT ITPA AL IDTD ILE 16 
ZL YSSAIIIAIISISI IASI ALIS AA SSAA S ASSIA AAS AS11171 | 20 
23 ee ae | 22 
25 Vaadaaaadidaaadidida 24 
27 LLLLLILILTILIPILL LILA ELTLT ADAPT LLIDTD TLE 26 
31 MRM A AA EEL ASS SARA EA SAMAR. 30 
33 Vadis 32 
35 Vad 34 
37 LPIPIILILTLLILALLALPILALL ILA EL ALTA IDA LE 36 


peewee ee ee eee eee eee terre ere eee eee eee eee + 


FIRQB+FQPPN This byte contains the following internal flag 
information: 


Bit Meaning When Set 


Placed file 

Some job has write access now 

File is open in update mode 

File is contiguous; no extend allowed 
No delete or rename allowed 

File is a UFD 

File is marked for deletion 


SHA BR WD EF 
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Errors 


BADFUO 


BSERR 


NODEVC 


NOTOPN 


The subfunction code passed in FIRQB+FQSIZM is a value 
other than zero or one. 


The channel number specified at FIRQB+FQFIL is outside 
the range 0 through 17. 


You requested FCB information (FIRQB+FQSIZM=1), but the 
file open on the I/0 channel specified at FIRQB+FQFIL 
is not a disk file. 


The I/O channel specified at FIRQB+FQFIL is not open. 
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UU.FIL (File Placement and Modification) 


Privileges Required 


Read access (by protection code, GREAD or WREAD privilege) is required 
to read file flags. Write access (by protection code, GWRITE, WWRITE, 
and/or SYSIO privilege) is required to set file flags. DATES is 
required to change last access date. SYSIO is required to set/clear 
the no-delete flag (P-bit). TUNE is required to set/clear file 


caching bits. 


Data Passed 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tee eee ee ee eee ee ee eee Se + 
nV AAA 
St Se + 
FQFUN 3 | UU.FIL (= -32) VAAL 
Se Se + 
FOSIZM 5 | function code | channel no.(1-17) | 4 FQFIL 
Se + 
si project number | programmer number | 6 FQPPN 
Horn ee eee ee ee ee eee Se + 
11 | file name in RAD50 format | 10 FQNAMI1 
+ (2 words) + 
L3:| | 12 
Se Se + 
15. | file type in RAD50 format (1 word) | 14 FQEXT 
Herre ee eee ee eee eee ee i + 
17 | least significant bits of block number | 16 FQSIZ 
Se Se + 
21 | MSB “of block number |placed/cache/seq.flg | 20 FQNAM2 
tenn eee eee eee ee eee eee Se + 
23 | new date of last access | 22 FQMODE 
Sl Si + 
25. | new date of creation | 24 FQFLAG 
terre ener eee eee eee eee torre ere eee eee eee ee eee + 
27 | new time of creation | 26 FQPFLG 
tee ere ee ee eee eee eee Sr + 
31 | 2- character(ASCII) device name (disk only)| 30 FQDEV 
Sl Sl + 
33 | , unit number real| device unit number | 32 FQDEVN 
tener eee ee eee eee eee Se + 


35 VA subfunction code | 34 FQCLUS 
BT VSSAAAISIIISISS SAIS IAAI ISSA S STAAL S117 \ 36 


FIRQB+FQFIL 


You can also place a zero in this byte and specify the 
file by file specification (device, PPN, file name, and 
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FIRQB+FQSIZM 


FIRQB+FQSIZ 


FIRQB+FQNAM2 


type). 


The system ignores the values in bytes 6 


through 15 and 30 through 33 if you use a nonzero 
channel number. 


This byte contains the following internal flags: 


Bit 


0 


Meaning When Set 


Set or reset file’s placed bit (cannot be used 
with bit 3). 


Used with bit 4 to return zero as the device 
cluster number if file’s placed bit is not set. 


Change file’s backup statistics. 

Change file’s run-time system name field. 
Return file’s retrieval information. 
Reset file’s contiguous bit. 


Enable/disable sequential mode caching if file is 
cached (cannot be used with bit 3). 


Enable/disable data caching on the file (cannot 
be used with bit 3). 


If bit 3 of FIRQB+FQSIZM is set, the two words 
beginning at FIRQB+FQSIZ are the new run-time system 
name in RAD50. 


This byte contains the following flags: 


Bit 


1 


Meaning When Set 


New value for placed bit if bit 1 of FIRQB+FQSIZM 
is set. 


New value for sequential bit if bit 6 of 
FIRQB+FQSIZM is set. 


New value for P-bit (no delete/rename allowed). 


New value for cached bit if bit 7 of FIRQB+FQSIZ2M 
is set. 
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UU.FIL 
FIRQB+FQCLUS Two subfunction codes currently in use are: 
Bit Meaning When Set 
0 Change the value of the file’s P-bit (see 
FIRQB+FQNAM2 ) 
1 Do not return protection violation. If clear, and 


Data Returned 


any of the requested functions cannot be 
executed, the monitor returns a protection 
violation error. If set, the monitor changes all 
valid requested functions and leaves the rest 
unchanged. 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tere rer ee eee eee eee 5 + 
1 OEE CLIT CACO ee, 0 
Se os + 
FQFUN 3 |£file characteristics 1 current job no. * 2 | 2 FQJOB 
Heer ee ee eee ee eee eee terre eee ee ee ee ee ee eee + 
5.1 device cluster number | 4 FQFIL 
tern re eee ee ee eee eee tere eee ee ee ee ee ee ee eee + 
7 | | 6 FQPPN 
+ + 
11 | | 10 
+ + 
Se ly 2 
+ + 
25: || file attribute data | 14 
+ + 
17 | (unused words are padded with NULLs) | 16 
+ + 
Zk" | 20 
+ + 
23 | | 22 
+ + 
25 | 24 
+ + 
27 °| | 26 
+ + 
31 | | 30 
+ + 
33 | | 32 
Herr reer ee eee ee ee eee tee e eee ee ee ee ee eee eee + 
35 | run-time system name in RAD50 format | 34 FQCLUS 
+ (2 words) + 
37 | | 36 
tee eee ee eee ee ee eee tere ee ee ee ee eee eee + 
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FIRQB+FQFUN 


Errors 


BADFUO 


NOSUCH 


NOTOPN 


PRVIOL 


File characteristics: 


Bit Meaning When Set 
1 File is placed 
2 File will be cached sequentially, if at all 
4 File is contiguous 
5 Current setting of file’s P-bit 
7 File will be cached when open 


File open is not a disk file or is a user file 
directory. 


File or account is not present on disk. 
Channel is not open. 


File open is not a disk file or job lacks necessary 
privilege (see FIRQB+FQCLUS in data passed). 
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{Hang Up a Dataset) 


Privileges Required 


-UU0 
UU.HNG 


HWCTL is needed to hang up a dataset, except on a keyboard line owned 
by the calling job. 


Data Passed 


Mne- Octal 
monic Offset 


FQFUN 


FQOSIZM 


ni 


3 


5 


Octal 


Mne- 


FOFIL 


Offset monic 


-UUO 
UU.HNG 
FIRQB+FQSIZM Use one of the following values: 

377 Sets "Data Terminal Ready" to permit a modem 
connected to a RSTS/E system to dial out. Ifa 
connection is not made in 127. seconds, perform 
an automatic hang-up of the dataset. 

0 Hang up in two seconds. 
1-177 Hang up in 1 to 127. seconds. 
Data Returned 
The UU.HNG subfunction does not return any data. 


Errors 


BADFUO Illegal KB number or insufficient privileges to hang up 
a line owned by another job. 
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/ U.JOB (Create Job) 
Privileges Required 
Set account access is required (GACNT or WACNT privilege) to spawn to 
another account. EXQTA is required to ignore job quota on spawn. 
JOBCTL is required to spawn a job even if no logins is set. TUNE is 
required to specify a priority when creating a job. WACNT is required 


to spawn a logged-out job. 


Data Passed ~ Logged-out job 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
5 Se + 
1 EOE AMSA AA SAME EEE SAMA ERASER 0 
ee ee + 
FQFUN 3 | UU.JOB (= 30) V/SPISTILLILT ELTA LLY 2 
Heer re ee ee ee ee eee +----------- i + 
SISSAAIAISISAS SSAA SASA1 7 | bit flags | 4 FQFIL 
Se tee eee ee eee ee eee eee + 
e. || project number | programmer number | 6 FQPPN 
terre ee ee eee ee ee eee Se + 
11 | file name in RAD50 format | 10 FQNAM1 
+ (2 words) + 
3) | 12 
terre ee ee ee ee eee eee tener eee ee eee eee eee + 
15: | file type in RAD50 format (1 word) | 14 FQEXT 
Se Se + 
17 | | 16 FQSIZ 
+ + 
21 | 10 bytes of | 20 
+ information to be + 
23 | placed in created job’s | 22 
+ core common area + 
25 | | 24 
+ + 
27 | | 26 
Se tere nce ee eee ee eee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
5 le tener re ee eee + 
33 | #0,unit ranean real | device unit number | 32 FQDEVN 
Sl SS + 
35 | parameter oie (see P.RUN) | 34 FQCLUS 
Sn es + 
37 Vdd 36 
Si + 
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FIRQB+FOQFIL 


FIRQB+FQPPN 
FIRQB+FQNAM1 
FIRQB+FQEXT 
FIROB+FQDEV 
FIRQB+FQDEVN 


The following bit flag is valid for a logged-out job: 
Bit Meaning When Set 
7 Create a job even if logins are disabled (JOBCTL 

privilege required). When this bit is not set, 
the job is created only if logins are enabled. If 
you do not have JOBCTL privilege, you must clear 
bit 7. 

All other bits must be 0. 


File specification of program to run. 
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UU.JOB 
Data Passed - Logged-in job to run a program 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
ae + 
1 PPILLILIPL ILA LLALLILL ILA ALILLTPLTLADL ADD 0 
See Sl + 
FOFUN 3 | UU.JOB (= 30) WALA he 
Se Se + 
FQSIZM 5 | KB to attach to | bit flags | 4 FQFIL 
Se ter ctr ee ee eee eee + 
7 | project number | programmer number | 6 FQPPN 
Se Herr ee ee eee + 
11 | file name in RAD50O format | 10 FQNAM1 
+ (2 words) + 
13 | | 12 
St Sl + 
15 | file type in RAD50 format (1 word) | 14 FQEXT 
St Sl + 
17 | project number | programmer number | 16 FQSIZ 
Se tre cre eee ee ee eee + 
21 | run burst | priority | 20 FQBUFL 
Se tee eee ee ee ee eee ee eee + 
23 WT maximum job size | 22 FQMODE 
Se ee + 
25 Vdd 24 
Sr + 
27 WLLL 26 
31 H device name (2 neck characters) i 30 FQDEV 
i Sl + 
33 | #0,unit number real | device unit number | 32 FQDEVN 
tee ere eee ee ee eee eee ee + 
35 | parameter word (see P.RUN) | 34 FQCLUS 
tener ee ee ee ee eee eee Herre ee ee ee eee eee + 
37 OG A A 36 
Sr + 
Note 
When you create a logged-in job, the system passes 
your current job’s core common and user logicals to 
the new job, regardless of privilege. The system 
temporarily stores this data in XBUF. 
FIRQB+FQFIL The following bit flags are valid when you create a 


logged-in job to run a program. 
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-UU0 
UU.JOB 


FIRQB+FQSIZM 


FIRQB+FQPPN 
FIRQB+FQNAM1 
FIRQOB+FQEXT 
FIRQB+FQDEV 
FIRQB+FQDEVN 


FIRQB+FQSIZ 


FIRQB+FQBUFL 
FIRQB+FQMODE 


Bit Meaning When Set 


1 Do not pass the user logicals of the creating 
account to the new job. (The contents of core 
common are still passed.) 


2 Create the new job with no privileges. 


3 Create the new job with the authorized privileges 
of the new job equal to the authorized privileges 
of the job’s account that are also current 
privileges of the calling job. If Bit 3 is clear, 
the new job is created with the authorized 
privileges of the job’s account. 


> Create a job to run under account specified at 
FIRQB+FQSIZ (GACNT or WACNT privilege required). 


6 Create a logged-in job. You must set this bit. 
The new job runs under the caller’s account 
unless you also set bit 5. 


7 Create a job even if logins are disabled (JOBCTL 
privilege required). When this bit is not set, 
the job is created only if logins are enabled. If 
you do not have JOBCTL privilege, you must clear 
bit 7. 


Set all bits you do not use to zero. 


Bits 0-6 indicate keyboard number to attach to. To 
specify KBO:, set bit 7 to one. A zero byte indicates 
a detached job. 


File specification of program to run. 


Account under which job runs (GACNT or WACNT privilege 
required; bit 5 at FIRQB+FQFIL must be set). If you do 
not have the necessary privileges, set both bytes to 0. 


If you specify zero, the system uses the caller’s 
values. Use one to explicitly specify priority zero. 
Only users with GACNT or WACNT privileges can specify 
these values. If you do not have the necessary 
privileges, set all three bytes to zero. 
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Data Passed - Logged-in Job to Enter a Keyboard Monitor at P.NEW 


FIRQB 


Mne- Octal Octal 
monic Offset Offset monic 


1 LIL COTE CERIS LO EAL OLLIE T 
FQFUN 3 | UU.JOB (= 30) VALILILTISILILILID ILE 


FQSIZM 5 | KB to attach to | bit flags | 


i run-time system name in RAD50 format 


+ (2 words) + 


Note 


When you create a logged-in job, the system passes 


your current job’s core common and user logicals to 


the new job, regardless of privilege. The system 


temporarily stores this data in XBUF. 


Mne- 


FQFIL 
FQPPN 


FQNAM1 


FOQEXT 
FQSIZ 
FOBUFL 


FQMODE 


FIRQB+FQFIL The following bit flags are valid when you create a 
logged-in job to enter a keyboard monitor. 
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FIRQB+FQSIZM 


FIRQB+FQNAM1 


FIRQB+FQSIZ 


FIRQB+FOBUFL 
FIRQOB+FQMODE 


Bit Meaning When Set 


1 Do not pass the user logicals of the creating 
account to the new job. (The contents of core 
common are still passed.) 


2 Create the new job with no privileges. 


3 Create the new job with the authorized privileges 
of the new job equal to the authorized privileges 
of the job’s account that are also current 
privileges of the calling job. If Bit 3 is clear, 
the new job is created with the authorized 
privileges of the job’s account. 


4 Enter keyboard monitor instead of running a 
program. (You must set this bit.) 


5 Create a job to run under account specified at 
FIRQB+FQSIZ (GACNT or WACNT privilege required). 


6 Create a logged-in job. (You must set this bit.) 
The new job runs under the caller’s account 
unless you also set bit 5. 


7 Create a job even if logins are disabled (JOBCTL 
privilege required). When this bit is not set, 
the job is created only if logins are enabled. If 
you do not have JOBCTL privilege, you must clear 
bit 7. 


Set all bits you do not use to zero. 


Bits 0-6 indicate keyboard number to attach to. To 
specify KBO:, set Bit 7 equal to one. The value of 
zero (detached job) is not allowed. 


The run-time system you specify must be installed and 
must be a keyboard monitor. Specify zero for the 
system’s default keyboard monitor (DCL). 


Account under which job runs (GACNT or WACNT privilege 
required; bit 5 at FIRQB+FQFIL must be set). If you do 
not have the necessary privileges, set both bytes to 
zero. 


If you specify zero, the system uses the caller’s 
values. Use one to explicitly specify priority zero. 
Only users with GACNT or WACNT privileges can specify 
these values. If you do not have the necessary 
privileges, set all three bytes to zero. 
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Data Returned (all types of jobs) 


Mne- Octal 
monic Offset 


Errors 


BADFUO 


NOBUFS 


NODEVC 


1 


3 


FIRQB 


I LPLILILILILILILILTLT EVID ID ILL ILI ID TLE 
ee te hee current job no. * 2 | 


I PLPILILILILT ITIL ILI LLLT IL ILALIL TLD AD UL IL IDE 


Sn + 


AAA hh 


PIILIPUL IL LL LIL ILL IT ITAL ADIL EL IL ALD TDT | 


Herter eee eee eee eee terete eee eee eee eee + 


WAAL hhh 


Octal 
Offset monic 


0 


2 


Mne- 


FQJOB 


FQFIL 


You specified a keyboard monitor at FIRQB+FQNAM1, 
did not supply a keyboard number at FIRQB+FQSIZM. 


You are trying to create a logged-in job, but not 
enough XBUF is available for temporary storage of your 


current job’s core common and user logicals. 


The keyboard number at FIRQB+FQSIZM is invalid. 
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but 


-UU0 
UU.JOB 


NOROOM Job cannot be created. Probable causes: 


o Logins are disabled and bit 7 (value = 200) at 
FIRQB+FQOFIL is clear. 


o The system’s job or swap slots are currently full. 


NOSUCH You have the necessary privilege and are trying to 
create a logged-in job, but the system cannot log the 
job in. Possible causes are that you specified a 
nonexistent account or an expired account. 


NOTAVL The keyboard specified at FIRQB+FQSIZM is open, is in 
use, or is not assigned to the calling job. A user 
without DEVICE privilege can also get this error if the 
system manager has restricted the device. 


PRVIOL You do not have the required privileges and tried to: 
o Create a job when logins were disabled. 
o Create a logged-out job. 


o Create a job to run under an account other than the 
current account. 


o Create a detached job that would cause you to 
exceed your detached job quota. (This quota is set 
by your system manager; its default value is zero.) 


Note that when you create a logged-in job, you can also get any error 
that can occur for the UU.LIN (Login), .RUN, and .RTS directives, 
because the monitor executes these directives for the new job. If an 
error occurs, the monitor kills the new job and returns the error to 
your job instead. 
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UU.LIN (Login) 


Privileges Required 


-UU0 
UU.LIN 


Set account access (GACNT or WACNT) is required to check the password 


of any account. 


Data Passed - Login Function 


Mne- Octal 
monic Offset 


FOFUN 


FQOSIZM 


1 


3 


A GARE AREER S CLEAN Kh MERAA SEAL Sal 


Eupeteon flag WALA 


password in RAD50 format 
(2 words) 


or 


password in ASCII format 
(14 bytes) 


WALA hhh 


+—+—4+—4+—-4+—-4+—4—4—-4+—4—4 


+—+—+—4+—4—4+—4+—4-—+4 
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Octal 
Offset monic 


0 


2 


Also, DEVICE is required if the device is restricted. 


Mne- 


FOPPN 


FQNAM1 


-UU0 
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FIRQB+FQSIZM The function flag bits are: 


Bit Setting 


0 Clear 
1 Clear 
Set 


In either case, 
C2 x 


question mark 


3 Clear 


Set 


Meaning 
Must be clear for the login function. 
The monitor assumes the password is six 
characters in RAD50 format. The 
password is converted to ASCII before 
comparison. 


The monitor assumes the password is 14 
bytes of ASCII data. 


the password must not contain a 

The monitor performs the password 
check. No privileges are required. 
The monitor suppresses the password 


check. However, GACNT or WACNT is 
required. 
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Data Returned 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Sr tenn re ee ee eee eee + 
1 ABSA E IESE ANE 6 CEA LEE ARENA LEAR ALL 0 
i ee ie + 
FQFUN 3: >| status flags current job no. * 2 | 2 FQJOB 
5 Sl + 
5 | total number of jobs under this account | 4 FQFIL 
Sl 5 i + 
7 |detached job no. (2) |detached job no. (1) | 6 FQPPN 
Se re + 
ne ae . | 10 FQNAM] 
+ ‘ + 
13° || [ee 
+ + 
15: | | 14 
+ zero byte marks end of list + 
17 | of detached job numbers. | 16 
+ + 
21. | only the first 25. detached | 20 
+ job numbers are returned. + 
23°) | 22 
+ + 
25-4 | 24 
+ + 
27 (| | 26 
+ + 
31 | | 30 
+ + 
33 | | 32 
+ + 
35 | | 34 
+ + 
i | 36 
tren eee ee ee ee eee ee pore ree ee eee ee eee + 


3-387 


-UU0 
UU.LIN 


FIRQB+FQFUN 


Errors 


BADDIR 


NOBUFS 


NOSUCH 


NOTAVL 


On §s 
oper 


uccessful return, indicates where the log-in 
ation has been completed. Values are: 


Value Meaning 


me 


-2 


The 


Success -- the job is logged in. 


Detached job quota exceeded. Job is not logged 
in; attach instead to some job from the list 
starting at offset FQNAMI1 


Total job quota exceeded. Job is not logged in; 
the value returned is the actual job quota. If 
there are any detached jobs, you can attach to 
one. 


account does not have all the necessary directory 


structures. 


No buffers are available to create the necessary 
internal structures. 


The 


1@) 


The 


monitor returns this error code if: 


The password specified at FIRQB+FQNAM1 does not 
match the password of the account on the system or 
contains question marks. 


The PPN specified at FIRQB+FQPPN does not exist or 
the project number is zero. 


System password validation is required for this 
type of job, and the account is marked "no-lookup," 
but the "verify system password" function has not 
yet been successfully executed. 


monitor returns this error code if: 


The PPN specified at FIRQB+FQPPN is expired or is 
marked as "no-interactive." 


The account is flagged as “no-dial-up" or 


"no-network" and the job is a dial-up or network 
job. 
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UuU.LIN 
Data Passed - Verify Password Function 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre eee ee ee ee eee ee eee terre er ee ee ee eee eee + 
LYSSAAIILALIIIIAIIAAA IAAI AS AAAS AAAS AAA AAS 11 /\ 9% 
Se tener ee ee ee ee ee ee eee + 
FOQFUN 3 | UU.LIN (= 4) WAAL he 
5 Se + 
FQSIZM 5 | function flag CAEL LG GEG ECC EMO 4 
i eis + 
7 | project number i programmer number | 6 FQPPN 
terre nee ee ee ee ee eee ten rrr eee ee eee + 
11 | | 10 FQNAM1 
+ password in RAD50 format + 
1 374ii (2 words) | 12 
+ + 
15 | Or | 14 
+ + 
|i password in ASCII format | 16 
+ (14 bytes) + 
21 | | 20 
+ + 
23 | | 22 
+ + 
25 | | 24 
| i + 
ZT VWAAASALIAIAAAIIIAAAS AAAI AAA AA AAA AAAS AAAS 7 | 26 
Sr Se + 
31 | device name (2 ASCII characters) | 30 FQDEV 
terre ee eee eee eee tee ree eee ee ee eee eee eee + 
33 | 40,unit number real | device unit number | 32 FQDEVN 
Herr rrr eee eee eee eee ten ene ree eee eee eee + 
35 Asdethcditbcdddbcdddddddddddddddddddddd 34 
i a + 
37 UE 36 
Herre eee eee ee ee ee eee tence eee eee eee ee eee + 


FIRQB+FQSIZM The function flag bits: 
Bit Setting Meaning 


0 Set The verify password function is 
performed. The caller supplies the 
password to verify in FIRQB+FQNAM1. 


1 Clear The monitor assumes the password is six 
characters in RAD50 format. The 
password is converted to ASCII data 
before verification. 
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UU.LIN 

Bit Setting Meaning 

1 Set The monitor assumes the password is 14 
bytes of ASCII data. 

In either case, the password must not contain any 

question marks. 
FIRQB+FQPPN A value of zero means use the caller’s PPN. 
FIRQB+FQDEV Device name of the disk on which to check. You must 


FIRQB+FQDEVN have DEVICE privilege if the device is restricted. 
Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.LIN 
subfunction does not return any meaningful data. 


Errors 

BADNAM Passwords do not match. 

DEVNFS Device specified is not a disk. 

NOSUCH Account specified is a nonuser account (no password 
data present) or does not exist. 

PRVIOL Caller does not have required privilege. 


Verify System Password Function 


This function verifies the system access password, if any. If there 
is no system access password, or if the password check has already 
been performed, the function returns successfully. Otherwise, the 
monitor compares the password supplied with the system password. A 
match sets a job flag which is tested by the login function; a 
mismatch generates the NOSUCH error. 


For compatibilty with old programs that perform a password lookup and 


then login, the login function does not require a system password on 
accounts where password lookup is allowed. 
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UU.LIN 
Data Passed - Verify System Password Function 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre ee ee ee eee tee eee ee ee ee eee ee eee + 
1 WEEE 0 
Se Se + 
FQFUN 3 | UU.LIN (= 4) WALA 
Sl 5 et + 
FQSIZM 5 | function flag = 6 |S//S/S/S/S/S/S/SIS/S/I////////\ 4 
Se a + 
UE UAALALALAL hhh 
Heer eee ee eee ee eee tenn eee ee ee eee ee ee eee + 
11 | | 10 FQNAM1 
+ + 
13° | 12 
+ + 
ES: || | 14 
+ + 
17 | password in ASCII format | 16 
+ (14 bytes) + 
21 | | 20 
+ + 
23 | | 22 
+ + 
25. .|| | 24 
Hr ee ee ee ee ee ee eee + 


ZT USSALSSIAALIISIAIAIS SSSI AAAS SISAL S ISIS SSS 71 71 \ 28 
31 VPLETPELLLSL LLL LALA STL IATAA TT ELS LAST LTLEA LS | 30 
33 VALE 32 
SS YSASSSSSISSIIIIIAAAAIT SSAA AAAS SSSA SSSA ASSL 7S \ 34 
ST VSAASLISISIAIIISSAIAAA ASSL SALAS AAAS 1111117 | 38 


Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.LIN 
subfunction does not return any meaningful data. 


Errors 


NOSUCH Password did not match the system password. 
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UU.LOG (Set Number of Logins) 

Privileges Required 

SWCTL is required to set the number of logins. 
Data Passed 


Mne- Octal Octal Mne- 
monic Offset Offset monic 


1 Vad 0 

FQFUN 3 | UU.LOG (= -23) VAPIITILILILI ITIL ILD 2 
DS ISISSIIII111/111111////\ “no. of allowed jobs | 4 FQFIL 
7 CAE Aa AAMAS OREN hE 6 


37 WL 36 


FIRQB+FQFIL A value of zero sets the number of allowed jobs to one. 
The upper limit for the number of logins is either the 
system JOB MAX or the number of jobs that can currently 
be swapped, whichever is lower. If you specify a 
larger value, the system sets the number of logins to 
the upper limit. In this case, no error is returned. 
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Data Returned 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
1  PSLLSSLLLLSSPPLPPPLAPLPSAA ALPS SPLS SPSS P 0 

3B ILIIIIISISAAAA1/6/////\ carrent job no. * 2 | 2 FQJOB 


SIUSSSIIII111/111//////\ actual logins set | 4 FQFIL 


Errors 


No errors are possible with the UU.LOG subfunction. 
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UU.LOK (Disk Directory Lookup by File Name/Wildcard Lookup) 
Privileges Required 

DEVICE is required to do a directory lookup on a restricted device. 
Read or execute access (by protection code, GREAD or WREAD privilege) 


is required to lookup another account. 


Data Passed - Look up by File Name 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Si terre eee ee ee ee ee eee eee + 
1 UREA AAAS AA GEA SAGAN MEMRAM E ID 0 
Se eos + 
FQFUN 3 | UU.LOK (= 21) Wn 2 
tee ee ee ee ee ee ee eee eee te -- eee ee eee ee eee eee + 
5: | (must = 177777) | 4 FQFIL 
+--- eee eee eee ee ee ee eee +---- eee ee ee ee eee eee + 
a project number | programmer number | 6 FQPPN 
tee ree ee ee ee eee ee eee tee eee ee ee ee ee eee eee + 
11 | file name in RAD50 format | 10 FQNAM1 
+ (2 words) + 
13 | | 12 
i tee eee ee ee ee ee ee eee + 
15 | file type in RAD50 format (1 word) | 14 FQEXT 
+--- eee ee ee ee ee eee eee terre eee ee ee eee eee eee + 
17 Wg a 16 
i eres + 
21 Vaasa 20 
Se ee i a i ers + 
23 Vaud 22 
Se i i i ee i io eis + 
25 A LPPILLLILPLIPPLLPPALIP SAPP TD PATA PALA TPS 24 
5 t--- eee ee ee ee ee ee eee + 
ZT VSASASIAAAIAAILAIA AAA AAA AAAS AAA AAA AAAS AAAS A171 \ 26 
Se t---- ee ee ee ee ee ee eee + 
31 | device name (disk) (2 ASCII characters) | 30 FQDEV 
terete te ee eee ee ee eee tee - ee ee ee ee ee ee ee eee + 
33 | #0, unit number aac device unit number | 32 FQDEVN 
i ios + 
35 aaaadaddadida 34 
+ wees es we we wees ee ee ew eeeeweeceso es es we ees ees ew eee sees ws ws = 
37 WEEE 36 
+------- eee ee ee eee eee Se + 
FIRQB+FQPPN zero in both bytes means the current account. 
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Data Returned ~- Look up by File Name 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herre ree eee eee ee eee teen ee ee eee ee ee eee eee 
1 idbbbddbbccddddcdiiddddddddidddddddddda 0 
+ ees se eee eee wee see se ww we ew ew woe ee we ew ew ee Be ewe ee eee eee ee 
3 MLL current job no. * 2 2 FQJOB 
+ ee ss we ee wwe eeeeeeeneweewe we eee we we er mee ew Dee wee we ee ee 
5.4 (= 177777) 4 FQFIL 
tere nee ee eee ee eee eee Henn eee ee eee eee eee 
7 | project number | programmer number 6 FQPPN 
Horr ee eee eee te 
i Fe file name in RAD50 format 10 FQNAM1 
+ (2 words) 
13 | 12 
tee ee ee ee ee eee ee eee Sc 
15> | file type in RAD50 format (1 word) 14 FQEXT 
tree eee eee ee ee eee eee terre ee eee eee ee ee eee 7 
17 | LSB of file length in 512-byte blocks 16 FQSIZ 
tee eee eee ee eee eee tence ee eee ee eee eee eee 
21 | MSB of file length | protection code 20 FQNAM2 
pore ee eee eee eee tence eee eee ee ee eee eee 
23 | date of last access 22 FQMODE 
tere ee eee eee eee ee eee tee eee ee ee ee ee eee eee 
25 | date of creation 24 FOFLAG 
freee eee ee ee ee eee ee tener ee ee ee eee eee eee 
27 | time of creation 26 FQPFLG 
pert eee eee eee ee nee tee ee eee eee eee eee eee 
31 | device name (disk) (2 ASCII characters) 30 FQDEV 
Herre eee ee eee eee t-te ee eee ee ee eee eee 
33 | #0, unit number real| device unit number 32 FQDEVN 
pert ee ee ee ee ee eee tee eee eee ee eee eee eee 
35 | file cluster size 34 FQCLUS 
perme eee re eee ee ee eee tee ee ee ee ee ee ee eee eee 
37 | file identification index 36 FOQNENT 
tere eee ee ee ee eee terre eee eee eee eee eee 
FIRQB+FQMODE System internal format for dates is: 
FIRQB+FQFLAG 
[(year - 1970.) * 1000.)] + day-within-year 
FIRQB+FQPFLG Time is in minutes until midnight, where 1440. equals 


midnight. 


See the .DATE directive for a discussion of these 


formats. 
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Errors 


BADNAM 


NOSUCH 


PAKLCK 


Data Passed - 


Mne- 


Octal 
monic Offset 


1 


The file name at FIRQB+FQNAM1 is missing or invalid. 


Device specified at FIRBQ+FQDEV is not a disk, or the 
file specified does not exist on the disk. This error 
also occurs when a user does not have read or execute 
access to the specified file. 


The disk is restricted and the account under which the 


call is executed does not have DEVICE privilege. 
Disk Wildcard Directory Lookup 
FIRQB 
Octal Mne- 


Offset monic 


VAAL 0 


FOFIL 
FQPPN 


| wildcard file name in RADS50O format | 
+ (2 words) + 


FQNAM1 


FQEXT 


FQMODE 


1 device name (disk) 


@ ASCII characters) H FQODEV 


FQODEVN 
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FIRQB+FQPPN zero in both bytes means the current account. 


FIROB+FQMODE Bit 14 set causes the monitor to return information 
about marked-for-delete files. 


Data Returned - Disk Wildcard Directory Lookup 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
oe tere eee eee ee eee eee eee + 
1 OE Oe 0 
Se ee es + 
3 LPPIILIITPILLLD AIT current job no. * 2 | 2 FQJOB 
Se tere ee eee ee ee eee ee eee + 
SI (same as data passed) | 4 FQFIL 
tee ee ee ee eee ee ee eee ter cee ee eee ee ee eee + 
7 | project number | programmer number | 6 FQPPN 
tern ee ee ee ee eee ee eee terre ere eee eee ee eee eee + 
EL. «| file name in RAD50 format | 10 FQNAMI1 
+ (2 words) + 
13. 5] | 12 
tee ee ee ee ee ee ee ee eee ee Here ee ee ee ee ee ee eee + 
15 | file type in RAD50O format (1 word) | 14 FQEXT 
tenner eee ee ee ee eee eee ten ee ee ee ee ee ee eee eee + 
Le. | LSB of file length | 16 FQSIZ 
tener ee ee ee ee ee ee eee tener ee ee ee eee ee ee eee + 
21 | MSB of file length | protection code | 20 FQNAM2 
tr rer ee ee eee ee eee eee tere ee ee ee eee eee eee + 
23 | date of last access (disk only) | 22 FQMODE 
Hee re ee ee ee ee eee eee terre eee eee eee eee eee + 
25 | date of creation | 24 FQFLAG 
tee eee eee ee ee ee ee eee tener ee eee ee eee eee eee + 
27 | time of creation | 26 FQPFLG 
teen eee ee ee ee eee ee eee tere ee eee eee eee eee eee + 
31 | (same as data passed) | 30 FQDEV 
+-------- meee eee eee eee terre eee ee ee ee eee eee + 
33 | (same as data passed) | 32 FQDEVN 
tee re ee ee ee ee eee eee tere nr ee er ee ee ee ee eee + 
35 | file cluster size (disk only) | 34 FQCLUS 
is per ee eee eee ee eee ee eee + 
37 | USTAT byte Me SLi AM GEE ALAM 36 FQNENT 
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-UU0 
UU.LOK 


FIRQB+FQNENT+1 This byte contains the following internal flag 
information: 


Bit Meaning When Set 
1 File is placed 
2 Some job has write access now 
3 File is open in update mode 
4 File is contiguous; no extend allowed 
> No delete or rename allowed 
7 File is marked for deletion 
Errors 
BADNAM The file name at FIRQB+FQNAM1 is missing or invalid. 
NOSUCH Device specified is not a disk or no file corresponds 
to the index given. 
PAKLCK The disk is restricted and the account under which the 


call is executed does not have DEVICE privilege. 
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-UUO 
UU .MNT 
_UU.MNT (Disk Pack Status) 

Privileges Required 


HWCFG is required to declare a mounted disk as restricted or 
unrestricted. MOUNT is required to: 


o Mount or dismount a shared disk 

o Dismount a /NOSHARE disk owned by another job 

o Mount a disk /NOSHARE for a job running under another PPN 
o Mount a dirty disk 


Data Passed 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herre ee ee ee eee eee Heer ee ee ee eee eee + 
LVSSAASASIIALIIAAS AAAS AAS AEA AAS AAS AAA AAAS AA \ 9 
peer rene te ee ee eee eee Se + 
FQFUN 3 | UU.MNT (= 3) WVAAAAAAA Ahhh 
torre ee eee eee ee eee tee eee eee ee ee eee eee + 
FQSIZM 5 | job number | subfunction code | 4 FQFIL 
Se tee ee re ee ee ee ee eee + 
7 TAOS AL AMEE CAE G ELLE ES MEUE DARA LEM 6 
pr ee pe ee ee eee eee eee + 
11 | pack identification label in RAD50 format | 10 FQNAMI1 
+ (2 words) + 
13. | im 2 
terre ee eee terre re ee eee ee ee eee + 
LS: “| =177777, use logical; =0, use pack ID | 14 FQEXT 
tener ee ee ee eee eee Se + 
17 | logical name for disk in RAD50 format | 16 FQSIZ 
+ (first 2 words) + 
21.4] | 20 
tee cere te ee ee eee eee tere eee ee ee ee ee ee eee + 
23 | mode word | 22 FQMODE 
fence eee eee eee tere reer eee eee ee ee eee + 
25 | 3rd word of logical name for disk (RAD50) | 24 FQFLAG 
0 tence ee eee eee eee + 
27 CELE CL RCL CE 26 
Se ie + 
31 | device name (2 eer characters) | 30 FQDEV 
torr ret ee eee eee eee tee - ee ee ee ee ee eee ee eee + 
33° | a unit number aie device unit number | 32 FQDEVN 
ie + 
35 VZaadddddddaddidda 34 
Se ie + 
37 PP PLLPPILLSLALLLL ELPA TPPAATSPATPPLELILTPD AE 36 
pen ee ee eee eee eee eee tee ee ee ee ee ee ee ee eee + 


-UUO 
UU .MNT 


FIRQB+FQFIL 


FIRQB+FQSIZM 


FIRQB+FQNAM1 


FIRQB+FQMODE 


The subfunction codes are: 


Code Meaning 
0 Mount a disk pack or cartridge 
2 Dismount a disk pack or cartridge 
4 Restrict a disk pack or cartridge 
6 Unrestrict a disk pack or cartridge 


Job number of the intended owner. Applies only if bit 
11 is set in FIRQB+FQMODE. Zero means the caller’s job 
number. If bit 11 in FIRQB+FQMODE is clear, this byte 
should be zero. 


For mount function: pack ID of pack to mount. Must be 
supplied unless bit 10 is set in FQMODE. 


The bits in the mode word are: 
Bit Meaning 
8 Mount Level 1.2 disk with /NOQUOTA 
10 Mount with lookup of pack ID 
11 Mount disk for use by single user(/NOSHARE) 


12 Mount disk read/write, even if disk was 
initialized as read-only 


13 Mount disk read-only 
14 Mount as a private disk (/PRIVATE) 
15 Must be set if any of the above bits are set 


You can set one bit or a combination-of bits. 
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Mne- Octal 
monic Offset 


Errors 


BADFUO 


BADPAK 


DEVNFS 


1 


3 


* Data Returned 


Vaeaaaauadiiia 
PILILILILILT ITIL ITT current job no. * 2 | 


pee eee eee eee ee eee Heer e eee eee ee eee eee + 


IL REEL ALANS AGE MAMAS ELLEE 


| logical name for alae in RAD50 format | 
+ (first 2 words) + 


| 3rd word of iegkcei & name for disk (RAD50) | 
St teen eee ee ee ee eee + 


Oh 


Octal 
Offset monic 


0 


2 


4 


-UU0 
UU.MNT 


Mne- 


FQJOB 


FQSIZ 


FOQFLAG 


You tried to mount a disk that is already mounted or 
that resides in a nondismounted drive, or drive 


specified is the system disk. 


Disk directory structure is invalid. For example, the 
cluster size is larger than 16 or the storage 


allocation table is unreadable. 


You tried to restrict, unrestrict, or dismount a disk 
currently open in non-file-structured mode. 
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HNGDEV 


INTPAK 


INUSE 


NODEVC 


NOTMNT 


PRVIOL 


WRGPAK 


You tried to mount a disk that is not write-enabled. 


The storage allocation table on the disk needs to be 
rebuilt because the disk was not properly dismounted 
when it was last used. Before using the disk, use the 
ONLCLN program to rebuild the storage allocation table. 


Note 


The MOUNT command automatically performs the 
rebuild operation if it is needed. 


Note that when this error occurs, the mount succeeds, 
but the disk is always mounted read-only with the 
"dirty" bit set. (You can see if this bit is set by 
looking at the output of the SHOW DISK command which 
reports that the disk is "dirty.") 


You tried to dismount a disk with an open file. 


Device type or unit at FIRQB+FQDEV is not on the 
system. 


You tried to lock, unlock, or dismount a disk that is 
not mounted. 


You tried to mount a disk that does not contain the 
RSTS/E file structure. Use the INITIALIZE command, the 
online DSKINT program, or the DSKINT initialization 
option to initialize the disk. 


You tried to mount a disk with an incorrect pack label. 
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'UU.NAM (Associate a Run-Time System with a File) 


Privileges Required 


-UUO 
UU.NAM 


File write access (by protection code or GWRITE, WWRITE, and/or SYSIO 
privilege) is required to set the run-time system name for a file. 


Data Passed 


Mne- Octal 
monic Offset 


FOFUN 


FQOSIZM 


l 


3 


per tee ee eee ee eee Henn ee eee eee eee eee + 


UZ eaddaaddiiidida 
| UU.NAM (= -21) VALILILILILIDILILILIL 


Sl Sl + 
| run-time channel number | 


emese ese weeeeneeee wm ee see eshbeeeeeeeeeeeeree es es ws we we ee 2 @ 
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Octal 
Offset monic 


0 


Mne- 


FOFIL 


FQPPN 


-UUO 
UU.NAM 


Data Returned 


Other than a possible error in byte 0 of the FIRQB, the UU.NAM 
subfunction does not return any meaningful data. 


Errors 
NOTOPN Channel is not open. 
PRVIOL File open on channel is not a disk file or the job executing 


the call does not have write access. 
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UU.NLG (Disable Further Logins) 


Privileges Required 


SWCTL is required to disables logins. 


Data Passed 


Mne- 


FOFUN 


Octal 
monic Offset 


1 


3 


Her eee eee eee ee Herr ee eee eee 


Vad 


Data Returned 


The UU.NLG subfunction does not return any meaningful data. 


Errors 


No errors are possible with the UU.NLG subfunction. 
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Octal 
gag monic 


Mne- 


-UUO 
UU.NLG 


- UU0 
UU .ONX 


UU.ONX (Open Next Disk File) 


This call opens a disk file or a series of disk files matching a 
wildcard specification. UU.ONX requires an I/O channel to use and 
grants access to the file. 


When you attempt an open next on a closed channel, UU.ONX finds the 
first file that matches the specification. When you attempt an open 
next on an open channel, UU.ONX finds the next file that matches the 
specification. If there are no more files that match the 
specification, UU.ONX closes the channel. 


Privileges Required 


DEVICE is required to perform an open next on a restricted disk. File 
read access (by protection code, or GREAD or WREAD privilege) is 
required to perform an open next for read access. File write access 
(by protection code, or GWRITE, WWRITE, and/or SYSIO privilege) is 
required to perform an open next for write access. 
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-UU0 


UU .ONX 
Data Passed 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se on ei + 
1 Vdd 0 
Sn + 
FQOFUN 3 | UU.ONX (= 41) WZ 2 
Se ee + 
5: i channel RGabeE * 2 | 4 FQFIL 
| Herre ene ee eee eee eee + 
7 | project number | programmer number | 6 FQPPN 
Herre ee ee ee eee eee ee tener eee ee ee ee ee eee + 
ll | file name in RAD50 format | 10 FQONAM1 
+ (2 words) + 
b3* *| | 12 
Sa Herter ee eee ee ee ee ee ee + 
15 | file type in seer format (1 word) | 14 FQEXT 
Se + 
17 Ueda 16 
et ld 
21 WLLL 20 
23 H ee pac H 22 FQMODE 
Se ee + 
25 Ueda 24 
Se + 
27 WLLL dda 26 
31 H device name (2 ASCII haces must be disk H 30 FQDEV 
peer ee eee ee ee ee eee Herne tee eee eee eee eee + 
33 | #0, unit no. real device unit number | 32 FQDEVN 
Se + 
35 Vad 34 
+ “ee es se we ewe eeweuunesewnwnenweneneweweee we we we we eee VwV3oVwnwvswzm eens e es & oO 
37 Vda 36 
ee Se + 
FIRQB+FQPPN The file owner’s PPN. Zero indicates the current 


account. Wildcards are not permitted in the 
specification. 
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-UU0 
UU.ONX 


FIRQB+FQS1IZ 


FIRQB+FQBUFL 
FIRQB+FQMODE 
FIRQB+FOQFLAG 


FIRQB+FQPFLG 


FIRQB+FQPROT 
FIRQB+FQDEV 
FIROB+FQDEVN 


FIRQB+FQCLUS 


FIRQB+FQNENT 


Errors 


BADFUO 


DEVNFS 
HNGDEV 


NOSUCH 


NOTMNT 


PAKLCK 


The LSB of the file’s size in 512-byte blocks. (See 
FIRQB+FQSIZM. ) 


The date of last access to the file. 
The date of creation of the file. 
The time of creation of the file. 


The file cluster size, modulo 256. That is, a file 
Cluster size of 256 is indicated by a value of zero. 


The protection code of the file. 

The device name, as two ASCII characters. 

The device unit number. 

The file identification index of the file. This word 
can be used instead of the file name in subsequent 
opens of the file. The file identification index is 
provided for compatibility with RSx. 

The description of the device just opened. The low 
byte contains the device’s handler index. The high 
byte contains a set of status flags to allow for 


device-independent I/O routines. (See the OPNFQ 
subfunction of CALFIP.) 


The parameters passed in the call are inconsistent with 
the currently open channel. 


You tried to open a device that is not a disk. 
Device is hung or write-locked., 


No more files match the specification. The channel is 
closed. 


The device is not mounted. 


The disk pack is restricted. You need DEVICE privilege 
to open a restricted disk. 


-UU0 
UU.PAS 
UU.PAS (Create User Account) 
Privileges Required 
Set account access (GACNT or WACNT) is required to create an account. 


Data Passed (V9.0 Format) 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herre re eee eee eee Herr ne ee ee eee eee + 
1 pe ET MME AID 0 
Se + 
3 | UU.PAS (=0) V/PAPILLILLILL ELT ILAE 2 
tere e er ee eee eee ee eee Herre ee ee eee ee ee ee eee + 
FQSIZM 5 | flags | preextnd UFD clstrs | 4 FQFIL 
Here eee ee eee ee eee Se + 
7 | device cluster number for UFD or -l | 6 FQPPN 
Hee eee eee ee ee eee ee eee Her ree re ee ee eee eee + 
11 | project number | programmer number | 10 FQNAM1 
tee ee ee eee ee ee ee eee eee tener eee ee ee ee ee eee + 
pi 12 
+ password (2 words in RAD50 format) + 
15> | 14 
Her reer eee ee ee eee frre eee eee ee ee eee + 
17 | LSB of logged-out quota (blocks) | 16 FQSIZ 
terre eee ee ee ee eee eee terre eee eee ee ee ee ee eee + 
21 | expiration date | 20 FQBUFL 
Herre tee ee eee eee eee terre ee ee ee ee eee eee + 
23 | LSB of logged-in quota (blocks) | 22 FQMODE 
Herre ce ee ee eee eee + 
25 | MSB logged-out quota| MSB logged-in quota | 24 FQFLAG 
Here ee ee eee ee eee Herr ee ee eee ee eee ee + 
ZT WAASAIIIIAIIIISAAAA AAAI AAA AAA AAA AS11111 74 \ 26) FQPFLG 
Herre tre eee eee eee eee Herne ee eee eee ee eee eee + 
31 | device name (2 ASCII characters) | 30 FQDEV 
Herre eee eee eee Henn ree eee ee ee eee eee + 
33 | #0, unit no. real | device unit number -| 32 FQDEVN 
Heer ee eee eee eee Herter ee eee eee eee + 
35 | UFD cluster size ee pack cluster size)| 34 FQCLUS 
Se + 
37 Veda 36 FQNENT 
+ ese mem eewzeenwenewe ese wee es we ew wee we et we ee ew ee ew eB hl hl hl hl hc Ohh hc hh ele le 
FIRQB+FQFIL zero means preextend one cluster. 


1-7 means preextend specified number of clusters. 
FIRQB+FQSIZM Flag byte. Bit 7 set means data passed in the FIRQB is 


in the new format. If bit 7 is clear, the data is in 
the V8.0 format. Other bits are reserved. 
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-UU0 
UU. PAS 


FIRQB+FQPPN 


FIRQB+12 


FIRQB+FQSIZ 
FIRQB+FQFLAG+1 


FIRQB+FQBUFL 


FIRQB+FQMODE 
FIRQB+FQFLAG 


Minus one means place UFD in the middle of the disk. 


Specify zero to create an account without setting a 
password. (Used to set long passwords; the password is 
set with a subsequent call to UU.CHU.) 


The logged-out quota in blocks. The LSB are in 
FIRQB+FQSIZ and the MSB are in FIRQB+FQFLAG+1. Use 377 
in all three bytes for an unlimited quota. Zero in all 
three bytes means no blocks can be allocated. 


Minus one means the account does not expire. This is 
the default. 


The logged-in quota in blocks. The LSB are in 
FIRQB+FQMODE and the MSB are in FIRQB+FQFLAG. Use 377 
in all three bytes for an unlimited quota. Zero in all 
three bytes means no blocks can be allocated. 
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' Data Returned 


Mne- Octal 
monic Offset 


1 


3 


Herre ree eee ee ee eee eee Herren eee ee ee eee eee eee + 


MOEA 


|device cluster ee for cluster 0 of UFD H 
0 terre ree eee eee ee eee + 
idevice cluster number for cluster 1 of UFD | 
Se tec ener ee ee eee eee + 
|device cluster number for cluster 2 of UFD | 


|device cluster number for cluster 4 of UFD | 
Sl 0 + 
{device cluster number for cluster 5 of UFD | 
0 el St + 
|device cluster number for cluster 6 of UFD | 
Se Sel + 
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Octal 
Offset monic 


0 


2 


-UU0 
UU. PAS 


Mne- 


FQJOB 


FQMODE 
FQFLAG 
FQPFLG 
FQDEV 

FQDEVN 
FQCLUS 


FQNENT 


-UUO 
UU.PAS 


Data Passed (Pre-v9.0 Format) 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tenn eee eee eee eee Hanne ee ee eee + 
L|SAAAIIIIIIIIIAAAAAA AAI A AAA AAA AAAS S17 \ ® 
Harr eee eee eee fener ee ee eee eee + 
3 | UU.PAS (=0) CASALL ALARA MALE 2 
+ sss es es ee eee eee ee wee ee eee ee ee ell hl whl hl hl hc hUc hULc Uc Mc BO le le 
FQSIZM 5 | flags H preextnd UFD clstrs H 4 FQFIL 
Se Se + 
7 | device cluster number for UFD or -l | 6 FQPPN 
Se pect eee eee + 
1l | project number | programmer number | 10 FQNAMI1 
tert nee ee ee eee eee tener ee ee eee eee + 
13 | | 12 
+ password (2 words in RAD50 format) + 
15 | | 14 
Sr tener ee ee eee ee + 
17 | number of blocks for quota; 0 = unlimited | 16 FQSIZ 
Sl i Dr + 
21 | expiration date | 20 FQBUFL 
Heer er ee eee eee tenner ee eee ee eee eee + 
23 UZ eddaadiiddsa 22 
i + 


a + 
31 | device name (2 ae ena eaceere) | 30 FQDEV 
terre ee ee eee eee terre m e ee eeeeeeeeee + 
33 | #0, unit no. real | device unit number | 32 FQDEVN 
Her rete eee ee ee ee eee pec ee ee ee ee eee ee eee + 
35 | UFD cluster size (0O=use pack cluster size)| 34 FQCLUS 
Herre en eee ee eee ee eee terre te ee ee ee eee eee + 
37 Ue ee ee 36 
i + 
FIRQB+FQFIL zero means preextend one cluster. 


1-7 means preextend specified number of clusters. 
FIRQB+FQSIZM Flag byte. Bit 7 set means data passed in the FIRQB is 
in the new format. If bit 7 is clear, the data is in 
the V8.0 format. Other bits are reserved. 
FIRQB+FQPPN Minus one means place UFD in the middle of the disk. 


Data Returned 


Same as for the V9.0 format. 
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UU.PAS 
Errors 
ABORT The account has been entered, and the directory has 
been preextended. However, the account has not been 
given a password or quota because an internal 
consistency check has failed. Submit an SPR if you get 
this error, and include: 

o A copy of the disk. 

o A snap shot dump. (Use the DUMP/SYSTEM command to 
copy the contents of memory to CRASH.SYS, then run 
the ANALYS program to save the information. Submit 
a listing that contains the ANALYS program’s 
output. ) 

See the RSTS/E System Manager’s Guide for more 
information on ANALYS. 

BADCLU Cluster size is either greater than 16 or is nonzero 
and less than the pack cluster size. 

BADCNT The number of clusters specified at FIRQB+FQFIL: 

o Is out of range. 

o When added to the device cluster number specified 
at FIRQB+FQPPN yields an effective address that is 
greater than the disk size. (See Appendix B for 
disk size information. ) 

DEVNFS Device is not a disk or the disk is open in 
non-file-structured mode. 

FIEXST Account specified already exists on device. 

NOROOM The monitor cannot allocate one cluster for the UFD you 
are creating because the disk is full. 

PRVIOL PPN is [0,0], or either the project number or 


programmer number is 255. 
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UU. POK 

UU.POK (Poke Memory) 

Privileges Required 

SYSMOD is required to write into kernel memory. 

Data Passed 

Mne- Octal Octal Mne- 
monic Offset Offset monic 


1 Vaddddddddddddidda 0 
FQFUN 3 | UU.POK (= -6) VYPVILILILILILILTL TTT 2 


5 er Se + 
| address of word to be changed | 4 FQFIL 
porte eee eee Sr + 
7 | new ee of word | 6 FQPPN 
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- UDO 


UU. POK 
Data Returned 
Except for a possible error in byte 0 of the FIRQB, the UU.POK 
subfunction does not return any meaningful data. 
Errors 
PRVIOL The job executing the call does not have SYSMOD privilege or 


the address specified is odd. 
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-UU0 
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UU.PPN (Wildcard PPN Lookup) 


Privileges Required 


DEVICE is required to perform a lookup on a restricted device. 


Data Passed 


Mne- Octal 
monic Offset 


a 


37 


Harner eee eee eee Herre ree ee ee eee eee + 


TR GA I EAE Se EA RAMEN ASAE. 
| UU.PPN (=31) VAILILILILILILILT LTD 


| el 5 + 
| index: n means search for n+l occurrence | 


| 377 or proj. no. | 377 or prog. no. | 
Se Se + 


BOT pO OCA I Ge) 


| device name (2 ASCII enwEEDE must be disk | 
Se 5 ae + 
| #0, unit no. real | device unit number | 
pore eee eee eee eee eee eee Si + 


EEG AINSI AS EE SEA KGL EU Mila MEAS ELH 


Octal 
Offset monic 


0 

2 

4 

6 
10 
12 
14 
16 
20 
22 
24 
26 
30 
32 
34 


36 


Mne- 


FOFIL 


FQPPN 


FQDEV 


FQDEVN 


FIRQB+FQPPN 377 represents a wildcard. Use zero in both bytes to 


indicate the current account. 


3-418 


Data Returned 


Mne- Octal 
monic Offset 


Errors 


NOSUCH 


PAKLCK 


1 
3 
5 


pene eee eee eee eee perenne ee eee eee + 


A OO ee) 


Ee See eee eve ee SNe erie eee a eR ee er a es ae ek Se eS eh ee - 


Octal 
Offset monic 


0 


2 


-UUO0 
UU.PPN 


Mne- 


FQJOB 


FQPPN 


FQODEV 


FQDEVN 


Device is not a disk, or no match exists for the specified 


index. 


The disk is restricted and the caller does not have DEVICE 


privilege. 
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-UUO 
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UU.PRI (Change Priority/Run Burst/Job Size) 


Privileges Required 


TUNE is required to change any job’s priority, run burst, or size. 


Data Passed 


Mne- Octal 
monic Offset 


1 
FQFUN 3 


FQSIZM 5 


37 


FIRQB+FQPPN 


FIRQB+FQNAM] 


| UU.PRI (= -15) VWYAPLIALISLILLATI TILT 
pect ete eee eee eee 5 a + 
| #0, change priority | job no.;377 = caller| 
5 i + 
| #0, change burst | new run priority | 
5 ele 5 + 
| #0, change size | new run burst | 
5 Se + 


UGA E IDEAL ALL maximum size | 


10. The value -200 suspends the job. 


Octal 
Offset monic 


0 
2 
4 


6 


Mne- 


FQFIL 
FQPPN 


FQNAM1] 


Run priority values range from -200 to 170 in steps of 


The run burst should be a value from 1 to 177. If you 


use a value outside this range, the monitor sets the 


run burst to 6. 
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FIRQB+FQNAM1+2 The maximum size can range from 1 to 377 (1K-word 
units). The system uses SWAP MAX if you exceed that 
value. 

Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.PRI 
subfunction does not return any meaningful data. 


Errors 


BADFUO The job number specified at FIRQB+FQFIL does not exist. 
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-UU0 

UU.PRV 

UU.PRV (Set/Clear/Read Current Privileges) 

The UU.PRV directive lets you read the current privilege mask or 
selectively set and/or clear bits in it. This function is distinct 
from the .SET or .CLEAR directives, which apply only when running a 
privileged program and then update the entire current mask at once. 
Privileges Required 


None 


Data Passed 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tener eee eee eee ee ee eee a + 
1 Ueda 0 
2 ee + 
FQFUN 3 | UU.PRV (= 34) Waa 2 
perenne ee eee eee eee eee terre ee ee eee eee eee + 
5). || | 4 FQFIL 
+ bits to be set in the + 
7 | current privilege mask | 6 
+ (4 words) + 
ey 4 | 10 
+ + 
13 | | 12 
Se ie + 
15 Ueaaaaddaaadidiida 14 
Si oe + 
17 Vaid 16 
Se i ee + 
21 | | 20 FQNAM2 
+ bits to be cleared in the + 
23 | current privilege mask | 22 
+ (4 words) + 
25. | | 24 
+ + 
27 | | 26 
i oe ee + 


31 WLLL 30 


33 WL 32 


35 WLLL 34 
37 Vad 36 
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FIRQOB+FQOFIL 


FIRQB+FQNAM2 


-UU0 
UU.PRV 


The bits to be set in the current privilege mask. If 


you do not want to set any privileges, use four words 
of zero. 


Before setting the specified bits, the system performs 
an AND operation between the bits the caller passes and 
the caller’s authorized privilege mask to prevent the 
caller from setting unauthorized bits. 


Note that this applies even for temporary privileges. 
Thus, a temporarily privileged program can use UU.PRV 
to drop any single privilege, but it can regain only 

those that the caller is authorized to have. 


The bits to be cleared in the current privilege mask. 
If you do not want to clear any privileges, use four 
words of zero. 


Note 


If all eight words are zero, no bits are set or 
cleared. Thus, the job’s privileges remain 
unchanged. This is the way to read your current 
privileges. 
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Data Returned 


Mne- Octal 
monic Offset 


1 


3 


37 


FIRQB+FQFIL 


Here eee ee ee eee eee Her ee eee ee eee + 


WR ee a 
current privilege mask 


+ 

| | 
+ + 
| | 
+ (4 words) + 
| | 
+ + 
| | 
+ 


LPILILILIILILIIL LILLIA ADIL ILTID EL AL TELL 


i Herne eee eee ee ee eee eee + 


WALLA hhh 


Note 


Octal Mne- 
Offset monic 


0 
2 
4 FQFIL 
6 
10 
12 
14 
16 
20 
22 
24 
26 
30 
32 
34 


36 


The bits set represent the privileges now in effect. 


A privileged program that wants to find out what 


privileges the user has needs to do a drop temporary 
privileges function followed by a read privileges 
function. 


Conversely, a privileged program that wants to check 


whether the program has the right privileges should 
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issue the read privileges function while temporary 
privileges are in effect. 


- UUO 
UU.RAD 
' UU.RAD (Read or Read-and-Reset Accounting Data) 

Privileges Required 
None required to read your own account. Set account access (GACNT or 
eo is required for all other accounts, or to reset accounting 
Data Passed 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herre eee ee eee Sr + 

1 UZ ddaaidda 0 
FQFUN 3 |  UU.RAD (= 16) VTLILIILITHLILITLIT\ 
5 | index number of account | 4 FQFIL 
read and reset | 6 FQPPN 
programmer number | 10 FQNAMI1 
13 VALLLLLLLLLLLLLLLLLL LL \ flag | 12 
L5 UV eddaddiaaiidia 14 
L7 UL adddadiddida 16 
21 Uae 20 
23 LPILLILI LILA LLILL IPA ILTTPTELIDTDT ILA LD 22 
25 OPEL SAGE EAE SENE ERIS SACRE LER 24 
27 Vad 26 
31 | device name (disk) a ASCII characters) | 30 FQDEV 
33 | #0, unit no. real ! device unit number | 32 FQDEVN 
35 WLLL 34 
37 VAPTILILLILT LILLIE PILALL ILA UL LTD ADDL TN 36 


FIRQB+FQPPN If the caller does have account access privilege, the 
system ignores this word and performs a read operation 
only. 
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FIRQB+FQNAM1+2 Flag byte. 


Bit 


0 


Setting 


Clear 


Set 


Clear 


Set 


Clear 


Set 


Clear 


Set 


Meaning 


Implies the call returns the number of 
blocks owned by the account. 


Implies do not return this data. Note 
that setting this bit to one can save 
considerable execution time (for Level 
1.1 or older disk structures) if you do 
not need the disk usage information 
otherwise returned to the word at 
FIRQB+FQPPN. 


Means the PPN at FIRQB+FQNAM] 
corresponds to a real account, if index 
value at FIRQB+FQFIL is zero. If index 
value is not zero, the system uses the 
index value and ignores any PPN at 
FIRQB+FQNAM1. 


Means the PPN at FIRQB+FQNAM1 contains 
a wildcard (377). 


Means the call returns general 
accounting information in the pre-v9.0 
format. 


Means return disk quota information in 
the v9.0 format. 


Means the call is a read-only lookup on 
the caller’s own PPN if the caller does 
not have GACNT or WACNT privileges. 


Means UU.RAD returns a protection 
violation error if a caller tries to 
perform a restricted function without 
having the required privileges. 
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Data Returned (Bit 2 set in FIRQB+FQNAM1+2) 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tee eee ee ee eee ee eee ten ee ee ee ee ee eee + 
1 [EAE CECE SAG MAM GUE OMAd ede 0 
“se 8*= ses eee eww wseweneen es we we ew eee ee ee hl hl hl hl hc rh hhh hl hl hh ele le + 
3 V/SIALISLILIILILLL ILLS | current job no. * 2 | 2 FQJOB 
to - eee nr ee eee eee perenne ee ee ee eee eee + 
Ss] (same as data passed) | 4 FQFIL 
Se Sr + 
7 PA AE A iOS ACARI EAE CMM 6 
eee + 
11 | PPN of ae eunt read | 10 FQNAM1 
tee ee ee ee ee eee eee Se + 
13 | LSB of logged-out quota | 12 
Sr tenner eee ee ee ee ee eee + 
ES: JI LSB of logged-in quota | 14 FQEXT 
Se Se + 
17 | MSB logged-out quota| MSB logged-in quota | 16 FQSIZ 
Se 5 el + 
21 | MSB current usage UASEREE ESSA AE RASS R 20 FQBUFL 
a ae + 
23 Vad 22 
Si + 
25 | LSB of mien usage | 24 FQFLAG 
Horr ree ee eee terre eee re ee eee ee eee + 
FQPROT 27 | count of open files and logged in jobs | 26 FQPFLG 
Sl Sr + 
31 | (same as data passed) | 30 FQDEV 
Se Se + 
33 | (same as data passed) | 32 FQDEVN 
Si 0 tl + 
B85 |SSSSIIIIAIA IAAI AAAIA AAA AAA A AAA AAA AAA A117 \ 34 
tee eee ee ee eee eee Se + 
37 WO ET 36 
Se ee + 


FIRQB+FQPFLG Count of open files is in bits 0-9. The number of jobs 
is in bits 10-15. 
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Data Returned (Bit 2 clear in FIRQB+FQNAM1+2) 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
ee ee + 


1 WLLL 0 


3 WLLL current job no. * 2 | 2 FQJOB 


ee + 
5 : (same as dete passed) | 4 FQFIL 
Se Herre eee eee eee eee + 
7 a number of blocks owned by account read | 6 FQPPN 
Herne ee ee eee a + 
ll | PPN of account read | 10 FQNAMI] 
terre eee eee eee ee eee freee ee eee eee + 
13 | password of account read (2 words in | 12 
+ RAD5O format) or zeros + 
15 | | 14 FQEXT 
Sel pert ee eee eee + 
17 | LSB of CPU time (.1 seconds) | 16 FQSIZ 
Herren eee ee ee eee ee eee terre eee ee eee eee eee + 
21 | connect time (minutes) | 20 FQBUFL 
Herre ee ee ee eee Herre eee + 
23 | LSB of KCTs | 22 
terre ete ee ee ee eee eee Herre ee ee ee ee eee + 
25 | device time (minutes) | 24 FQFLAG 
Se fern ee eee eee eee eee + 
FQPROT 27 | MSB of CPU time | MSB of KCTs | 26 FQPFLG 
Se Herre ere eee ee ee eee + 
31 | (same as data passed) | 30 FQDEV 
terete ee ee eee eee eee eee tener ree eee eee ee eee + 
33 | (same as data passed) | 32 FQDEVN 
terre eee ee eee ee eee eee terete eee ee eee eee eee + 
35> | disk quota in blocks; 0 = untenrted | 34 
terre eee ee eee eee eee eee tec ee eee eee eee ee ee eee + 
37 | UFD cluster size | 36 
torre ee ee eee eee terre eee eee eee eee eee + 
FIRQB+FQPPN If the byte at FIRQB+FQNAM1+2 in the data passed is l, 


this word is zero. 


FIRQB+FQNAM1+2 If the caller has GACNT or WACNT privilege and the 
account allows password look-up, the password is 
returned as 2 words of RAD50. Otherwise, zeros are 
returned. 


FIRQB+FQSIZ The LSB of the CPU time in tenths of a second. See the 
byte at FIRQB+FQPROT for the MSB. 


FIRQB+FQMODE The LSB of the Kilo-Core-Ticks (KCTs). See the byte at 
FIRQB+FQPFLG for the MSB. 
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» Errors 


BADDIR 


BADFUO 


NOSUCH 


PRVIOL 


-UUO 
UU.RAD 


The account does not have all the necessary directory 
structures. 


Device specified is not a disk. 

The PPN specified does not exist on the disk, or the 
index specified is greater than the number of accounts 
on the disk. 


The caller does not have sufficient privilege to 
perform the indicated function. 
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UU.RTS (Add/Remove/Run-Time System or Resident Library, or Create 
Dynamic Region) 

Privileges Required 

Read access (by protection code, GREAD, WREAD, and/or SYSIO privilege) 
is required to install a run-time system or resident library. INSTALL 
is required to install, remove, load, or unload a run-time system or 


resident library, or create a dynamic region. 


Data Passed - Add a Run-Time System 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tenner ee ee ee eee eee tener er er ee ee ee ee eee + 
LUSAIIISIIIAIIIAIAA IAA ALAA IAAI AA AAAS AS11174 \ 
tener ee ee eee ee ee ee eee tener eee ee ee eee eee eee + 
FOFUN 3 | UU.RTS (= -22) WALLA he 
t-- eee ee eee eee ee ee eee Se + 
SUSSSAAAIASSII1 SAAS Z | flag | 4 FQFIL 
teen ee ee ee ee ee eee eee tenn te ee eee ee ee ee eee + 
7 | project number | programmer number | 6 FQPPN 
ee Se + 
11 | run-time system name | 10 FQNAM1 
+ + 
13 | (2 words of RAD50) | 12 
terre ree eee ee ee eee eee Herr eee ee ee ee eee + 
iS.” start load address or zero | 14 FQEXT 
Se Herr ee ee ee eee ee eee + 
17 | max. user job image size, K words (P.SIZE)| 16 FQSIZ 
teen ree ee ee eee eee eee tere ree ee ee ee ee eee eee + 
21 | min. user job image size, K words (P.MSIZ)| 20 FQBUFL 
terete ee ee ee eee ee eee tener tee eee eee eee ee eee + 
23° | stay flag | linked-list position| 22 FQMODE 
terre eee eee ee eee eee Hen re ee ee ee ee eee + 
Z25° 4 flag word (P.FLAG) | 24 FQFLAG 
tee errr ee ee ee ee eee ee eee tern err eee ee eee + 
FQPROT 27 | dflt. exec. file type (P.DEXT), RAD50 | 26 FQPFLG 
Hence ee ee eee eee eee Herr re ene ee eee eee eee + 
31 | device name (disk) where stored | 30 FQDEV 
tore n eee eee ee eee eee Se + 
33 | #0, unit no. real | device unit number | 32 FQDEVN 
tenn ee ee ee eee eee tere eee eee ee ee eee + 
35 el ace eae 34 
5 el + 
37 YP LPILLILTILTALALLIPLT LT APIELATLATALL ADDED 36 
Sle terre eee ee ee ee eee eee + 
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FIRQB+FQFIL All bits clear implies the values for P.SIZE, P.MSIZ, 


P.FLAG, and P.DEXT symbols are in the call. 


Bit 7 set means the system should obtain the values for 
these symbols from the .RTS file. 


FIRQB+FQEXT If zero, the monitor calculates the start load address 


each time the run-time system is loaded. Otherwise, 
the start load address is K times the value specified. 


FIRQB+FQMODE+1 All bits clear means the memory occupied by this 


run-time system can be released when usage count goes 
to zero. 


Bit 7 set means the run-time system is permanently 
resident. 


Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.RTS 
subfunction does not return any meaningful data. 


Errors 


BADCNT 


FIEXST 


NOBUFS 


NOROOM 


NOSUCH 


PRVIOL 


The range of memory starting at the load address at 
FIRQB+FQEXT is not available. See the output of the SHOW 
MEMORY command to select an available range of memory. 


A run-time system with the same name already exists. 


Adding a run-time system description block requires a small 
buffer and none is currently available. 


If loaded at address specified, memory is fragmented and a 
Swapping violation occurs. See the discussion of assigning 
and allocating memory in the RSTS/E System Installation and 
Update Guide for guidelines on how to avoid fragmenting 
memory. 


No file with the name given and a type of .RTS can be found 
in the account at FIRQB+FQPPN on the device specified. 


The file to be added has a bad format. For example, it is 
not contiguous or has illegal entries in the SIL index. 
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Data Passed - Remove a Run-Time System 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 


i Uda 0 

FQFUN 3 | UU.RTS (= -22) WZ 2 
5 Ua subfunction code =4 | 4 FQFIL 
7 Waeeaddida 6 


run- cine system name 10 FQNAMI 


(2 saa of RAD50) 12 


15 UZ dddaadddadidda 14 
17 Wadia 16 


21 WLLL 20 


23 WL 22 
25 Uda 24 
27 WLLL 26 


31 WLLL 30 
33 WLLL 32 
35 Vad 34 


37 WLLL 36 


Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.RTS 
subfunction does not return any meaningful data. 


Errors 

INUSE This run-time system is currently being loaded into memory 
or is resident and in use. It cannot be removed until the 
usage count is zero. 


NOSUCH The run-time system is not currently defined. 
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PRVIOL The run-time system is the primary run-time system or the 
system default keyboard monitor and cannot be removed with 


this call. 


Use the DEFAULT initialization option to change 


the primary run-time system before starting timesharing. 
The system default keyboard monitor is always DCL. 


Data Passed - Unload a Run-Time System 


Mne- Octal 


monic Offset 


l 


FOFUN 3 


FIRQB 


Octal Mne- 


: UU.RTS (= -22) VWILILILTIVILILILIL IST 


were eee ee ee eee He ne ee ee eee ee nt 


WZ subfunction code =6 | 


i run- ety system name 


: (2 tars of RAD50) 


Data Returned 


Except for 


a possible error in byte 0 of the FIRQB, the 


subfunction does not return any meaningful data. 
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Offset monic 


0 
2 


4 FQFIL 


10 FQNAM1 


UU.RTS 
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Errors 


INUSE 


NOSUCH 


Data Passed - 


The run-time system is currently being loaded or is resident 
and in use. It cannot be unloaded until usage count is 
zero. 

The run-time system is not currently defined. 


Add a Resident Library 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se oe + 
1 Vad 0 
Se + 
FQFUN 3 | UU.RTS (= -22) UZ 2 
Si ee + 
5 WLLL subfunction code=20 | 4 FQFIL 
-—ses cee wreeese ewe ewr eee ee edb we we ee ere ee ee ew ew es eB Bw Bw © eB ee + 
7 i project number H programmer number | 6 FQPPN 
Sr Here eee eee eee eee + 
ll | run-time system name | 10 FQNAM1 
+ + 
13 | (2 words of RAD50) | 12 
Se tee ee eee ee ee eee eee eee + 
LS: 4 start load address or zero | 14 FQEXT 
Se tence ee eee eee eee eee eee + 
17 EEL MAA EERE EEE ERE KAAS EKA A EEO | 16 
Si + 
21 I PPLPLILLILL ISLA ALPALLAAPALPAAPATPYTLTAD 20 
teen ree ee eee eee eee Here ee eee ee ee eee + 
23 | stay flag VALE ECR A ALLE 22 FQMODE 
Se + 
25 | flag eee | 24 FQFLAG 
Heer e ener eee ee ee eee terre ee eee eee ee eee + 
FQPROT 27 | protection code | #0, prot.code real | 26 FQPFLG 
Sr terre ee eee eee eee eee + 
31 | device name (disk) where stored | 30 FQDEV 
terete ee eee ee ee eee perenne ee ee ee ee eee + 
33 | #0, unit no. real | device unit number | 32 FQDEVN 
Si ie + 
35 “ddd 34 
37 Wedd 36 
Se + 
FIRQB+FQEXT If zero and the library requires a fixed address, the 


monitor finds the address progressing from high to low 
memory. Otherwise, the monitor calculates the start 
load address when the library is actually needed. 
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If -1, the monitor finds the first free space large 
enough to hold the library, starting from the top of 
memory. 


Otherwise, the start load address is K times the value 
specified. The value can be in the range 1 to n-l; 1 
means the first available 1K word section and n is the 
total number of 1K word sections available on the 
system. 


FIRQB+FQMODE+1 All bits clear means the resident library can be 


- FIRQB+FQFLAG 


removed from memory when usage count goes to zero. 


Bit 7 set means the resident library is permanently 
resident. 


Bit settings indicate resident library characteristics: 
Bit Setting Meaning 
9 Set The resident library is to be accessed by 
only one user. That is, the library is not 


to be shared. 


Clear The resident library can be shared by more 
than one user. 


10 Set Read/write access is allowed. 
Clear Read-only access. 
12 Set Errors occurring within code in the 
resident library are not to be recorded in 


the system error log. 


Clear Errors may be recorded in the system error 


log. 

13 Set The resident library is immediately removed 
from memory when its usage count goes to 
zero. 


Clear When the usage count for this library goes 
to zero, the monitor will remove it from 
memory when the space it takes is needed 
for something else. 


All other bits are reserved and should be zero. 
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Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.RTS 
subfunction does not return any meaningful data. 


Errors 

BADCNT You did not specify a load address, or the one specified is 
not available. See the output of the SHOW MEMORY command to 
find an available range of memory. 

FIEXST A resident library with the specified name already exists. 

NOBUFS Adding a resident library description block requires a small 
buffer and none is currently available. 

NOROOM If loaded at address specified, memory is fragmented and a 
Swapping violation occurs. See the discussion of assigning 
and allocating memory in the RSTS/E System Installation and 
Update Guide for guidelines on how to avoid fragmenting 
memory. 

NOSUCH No file with the name given and a type of .LIB can be found 
for the given account and device. 

PRVIOL The file to be added has a bad format. For example, it is 


not contiguous or has illegal entries in the SIL index. 


3-436 


‘Data Passed - Remove a Resident Library 


Mne- 


monic Offset 


FOQFUN 


Octal 


1 


3 


FIRQB 


Octal 


| resident tibeacy name | 


| (2 oe of RAD50) | 
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0 


2 


4 
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Mne- 


Offset monic 


FOFIL 


FQNAM1 
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Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.RTS 
subfunction does not return any meaningful data. 


Errors 

INUSE You tried to remove a library that is being loaded into 
memory or is in use. A resident library cannot be removed 
while a job is attached to it. 

NOSUCH You specified a resident library that is not currently 


defined. 
Data Passed - Unload a Resident Library 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 OO CE 0 
FOQFUN 3 | UU.RTS (= -22) VWYSPIISSPALSLAALSSA LL | 2 


SISIISISI1111111//1////\ sabfunction code=26 | 4 FQFIL 


11 | resident ibeare name | 10 FQNAM1 
13 | (2 mess of RADS50) hb -E2 
15 LLILLILLLT ILIA ILIAD LAELIA ADIL ED LTTE 14 
17 LEE LEN EEA EACH MAGS CLARA lal liad 16 
21 LPLLILILILILALTULILILILA LD ILILTLILT ED ID ILD 20 
2B ISSASASSIIIIATSAAII SISA AA ASIA AAAS SASS AAA AL \ 22 
25 TELA EAE AA ELA AALE LN EL LE SEEK EL RA EKO 24 
27 Vedaaadiiadia 26 
31 VU dadddddddddda 30 
33 I LLILILI ITIL ILILILALLLLILTDD ITED ALLL T LTD 32 
35 AEE MASA EAA SALE AERA LA GAGA 34 
37 Vad 36 
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Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.RTS 
subfunction does not return any meaningful data. 


Errors 

INUSE You tried to unload a resident library that is now being 
loaded or is in use. A library cannot be unloaded while a 
job is still attached to it. 


NOSUCH You specified a resident library that is not currently 
defined. 


Data Passed - Create Dynamic Region 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset eek monic 
ee 
1 Vad 0 
Sn as + 
FQFUN 3 | UU.RTS (= -22) WZ 2 
Se ee rr er 
) Vee subfunction code=30 i 4 FQFIL 
Se + 
7 Vad 6 
Sn ee es + 
ll | dynamic reaion name | 10 FQNAM1 
+ + 
13 | (2 words of RAD50) | 12 
Se Herr ee ee ee eee eee eee + 
15 | start dynamic region address | 14 FQEXT 
Se perc tee ee eee eee eee + 
17 EA AM else dynamic region size | 16 FQSIZ 
Sn as + 
21  LLPILLLTILAALALLAPLLALAPLAPLAPL APPL TD DE | 20 
tenn rere ee eee eee eee Herre eee ee eee eee eee + 
23 | creation flags | 22 FQMODE 
tence ne eee eee eee eee Hoenn eee ee ee eee eee + 
25 | region flags | 24 FQFLAG 
tere eee eee eee eee eee Her eee ee ee eee ee eee + 
FQPROT 27 | protection code | protection code flag| 26 FQPFLG 
eS + 
31 VZeaadadadida 30 
Sn os + 
33 adda 32 
Se So + 
35 WLLL 34 
eee, meeesese ee ees ee ws we ew ew ew we ewe he we eh Bw el el ll le + 
37 ULL 36 
Herre ee ee eee ee eee eee terre eee ee eee eee eee + 
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FIRQB+FQNAM1 


FIRQB+FQEXT 


FIRQB+FQSIZ 


FIRQB+FQMODE 


FIRQB+FQFLAG 


FIRQB+FQPFLG 


FIRQB+FQPROT 


If zero, the monitor creates an unnamed dynamic region. 
The starting address of the dynamic region is K times 
the value of this word. If zero, the monitor computes 
the starting address for the dynamic region. 


The size of the region in K words. The value can be in 
the range 1 to 177. 


Creation flags. The following bits are currently 
defined: 


Bit 7, when set, means attach this job to the named 
region. 


Bit 15, when set, means do not delete this region even 
if all users detach from it. 


All other bits are reserved and should be zero. 

Region flags. The following bit is currently defined: 
Bit 9, when set, means this region cannot be shared. 
All other bits are reserved and should be zero. 

If nonzero, then the value in FIRQB+FQPROT is real. 


The protection code of the region. 
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Data Returned - Create Dynamic Region 


Mne- Octal 
monic Offset 


1 


FIRQB 


EOE MLIE SELLA KERNELS SA GSMA Eh M IAS 


WMI dynamic region size | 


Octal 
Offset monic 
i ee + 


0 


2 


36 


FIRQB+FQPPN The ID of the created dynamic region. The 


FIRQB+FQSIZ 


directives use this ID. 


value can be in the range 1 to 177. 
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Mne- 


FQPPN 


FQSIZ 


- PLAS 


The size of the created dynamic region in K words. 


The 
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Errors 


BADCNT 


FIEXST 


NOBUFS 


NOROOM 


You tried to create a region with an illegal size 
specification or the load address was not valid. 


You specified the name of a dynamic region or resident 
library that already exists. 


A small buffer was not available for the region 
description block. Also, if attachment was specified, 
a small buffer was not available for the window 
descriptor block. 


If the dynamic region was loaded at the specified 
address, memory is fragmented and a swapping violation 
occurs. If the monitor was choosing the address, there 
is not enough free memory to create the region. 
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‘UU.SLN (System Logical Names) 

Privileges Required 
INSTAL is required to add, remove, or change system logical names. 
Data Passed ~- Add New Name 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 VZaadddddadidddda 0 
FQFUN 3 | UU.SLN (= 25) WZ 2 
| 9 UZ subfunction code= 1 i 4 FQFIL 
7 | PPN for this name ire 0, none associated) | 6 FQPPN 
i Se + 


logical name in RAD50 format 
(3 words) 


| 10 FQNAM1 
+ 
13 12 
+ 
| 14 
L7 WLLL 16 
21 WLLL 20 
23 Vad 22 
25 WLLL 24 
27 WLLL 26 
31 | device name (2 Rceit characters) | 30 FQDEV 
33 | must #0 | device unit number | 32 FQDEVN 
35 WLLL 34 


37 WLLL 36 
FIRQB+FQFIL This code adds a new entry to the list of system 
logical names. 
Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.SLN 
subfunction does not return any meaningful data. 
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Errors 

BADNAM No logical name was given or the name contains invalid 
characters. 

INUSE The logical name given duplicates one already in use. 

NOBUFS An attempt was made to extend the logical name table 
and there was no room in XBUF. 

NODEVC The device specification is illegal or is not on the 


system. 
Data Passed -- Remove Logical Name 
FIRQB 

Mne- Octal Octal Mne- 
monic Offset Offset monic 

1 Uaddddadiidda 0 
FQFUN 3 | UU.SLN (= 25) WLLL 2 

2 WLLL subfunction code= 0 i 4 FOQFIL 

7 WL 6 


logical name in RAD50 format 10 FQNAM1 


(3 words) 


+ 
| 
+ 
| 12 
+ 
| 14 
+ 
17 OR Ge Ce ee 16 
21 Vaid 20 
23 Vdaddddadiddaiidia 22 
25 Vda 24 
27 Vdaddaaaddddda 26 
31 VL aaaaadadidida 30 
33 Vdd 32 
35 Vad 34 


37 Uddaddddddaaaidiida 36 
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‘Data Returned 
Except for a possible error in byte 0 of the FIRQB, the UU.SLN 
subfunction does not return any meaningful data. 
Errors 
BADNAM No logical name was given or the name contains invalid 
characters. 
NOSUCH The name given is not currently defined as a logical 
name. 
Data Passed - Change Disk Logical Name 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se ee + 
1 Uaadadaadiadidda 0 
i ee 
FQFUN 3 | UU.SLN (= 25) WLLL 2 
ee ee ee 


5 WLLL subfunction code=-1 ! 4 FOQFIL 


Se + 
11/4 logical name in RAD50 format | 10 FQNAMI1 
+ (3 words) + 
13 | | 12 
+ + 
L5: + | 14 
SS i + 


31 | device name (2 eee characters) | 30 FQDEV 


33 | must #0 | device unit number | 32 FQDEVN 
i terre ee ee ee ee + 


35 EAE NAAN ALES REAL GEALEEA LEAMA LS 34 


-UUO 
UU.SLN 


FIRQB+FQFIL This code changes the logical name associated with a 
disk in the list of system logical names. 
Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.SLN 
subfunction does not return any meaningful data. 


Errors 

BADNAM No logical name was given, or the name contains invalid 
characters. 

INUSE The logical name given duplicates one already in use. 

NOSUCH The disk specified is not on the system. 

NODEVC The device specified is illegally formatted or is not a 


disk. 
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‘Data Passed ~- List Logical Name 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se terre eee ee eee eee eee eee + 


Z A ELLA ARAN SEL SAE L ES EAM 0 
FQFUN 3 | UU.SLN (= 25) WLLL 2 
a tere eee ee ee ee ee ee ee eee 
5 UAL MAE AAMLL LLL subfunction code= 2 | 4 FQFIL 


7 H index | 6 FQPPN 


37 WLLL 36 


FIRQB+FQPPN Index. An integer representing the relative position 
of the specified logical name in the list of system 
logical names. You can list all logicals by repeated 
calls with an index value starting at zero and 
incremented by one each time. 
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Data Returned 


; FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
i re pene eee ee ee ee ee eee + 
1 EEA SARL LALA SERENE RAKE ASHE GACAMAE 0 
+ see weeevsveweenweweneeneeweeeaeeek nwa wee weweeweweewewennwne wen eew5we + 
3 Veda 2 
+ =e spss emeeeeenweeanewnenene ws eb se we ee ew eee wewen sc we we Bee @ + 
5 Veda 4 
+ esse ee eweewesneneeweeeewewebk ne we wB ewe tees sense eee see =o + 
7 | project number i programmer number | 6 FQPPN 
terete eee ee ee ee ee ee eee terre ere eee eee eee + 
a A logical name in RAD50 format | 10 FQNAM1 
+ + 
13 | (3 words) | 12 
+ + 
15. | | 14 
teen re eee ee ee ee eee eee peer ee ee ee eee ee eee + 


17 OWE 16 
21 Wa 20 
23 Vdd 22 
25 Vad 24 
27 Vad 26 
31 | device name (2 Pee characters) | 30 FQDEV 


33 | must #0 | device unit number | 32 FQDEVN 
Henne eee ee ee eee eee Se + 


85 ISAAAIIAI1111111111'07'7 | mount flag | 34 FQCLUS 


tree ee eee eee eee pect eee eee eee eee ees + 
BST SSSA IAIIAIIA ASAI AAAS AAA AAA A AAA AAA | 38 


Henn n ree eee eee eee per eee eee ee eee + 


FIRQB+FQCLUS The value of this byte is 377 if the indexed logical is 
a disk and the disk is not mounted. 


Errors 


NOSUCH Index out of range. 
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‘ UU.SPL (Spooling) 


RSTS/E currently has two spooling packages: the Print/Batch Services 
(PBS) package and the OPSER-based package. When you execute the 
UU.SPL directive, the system first looks at the spooled device name 
field (FIRQB+FQSIZ). The monitor, by default, routes the request to 
PBS if it is running and the field is null or LP, or it is BA and the 
file type is .COM. Otherwise, the monitor routes the request to the 
OPSER-based package. 


Note that by setting a bit in FQFLAG, you can force the request to be 
sent to whichever spooling package you want. 


For requests routed to PBS, any request parameter that cannot be 
passed by UU.SPL is assigned a default value. 


Privileges Required 


File read access (by protection code, or GREAD or WREAD privilege) is 
required to queue a file. File write access (by protection code, or 
GWRITE or WWRITE privilege) is also required to queue a file with the 
delete option flag. DEVICE privilege is required if the file is ona 
restricted device. 
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Data Passed 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tence ee eee Sr + 
1 Vea 0 
Sr pore ere eee eee + 
FQFUN 3 | UU.SPL (= -34) WZ 2 
Se a + 
5 WLLL 4 
7 i project number 1 programmer number H 6 FQPPN 
t--- eee eee ee eee ee eee Herr te ee eee eee + 
A ie wildcard file name in RAD50 format | 10 FQNAM1 
+ (2 words) + 
13 | ie. 
teen eee eee eee eee tener ree eee eee ee ee eee + 
15 |wildcard file type in RAD50 format (1 word)| 14 FQEXT 
Se tee rte ee eee eee eee + 
17 |device name to queue to (ASCII); 0 = "LPO" | 16 FQSIZ 
Horner ee eee eee eee terre eee ee ee eee eee ee + 
21 |device unit real see device unit number | 20 FQBUFL 
i i + 
23  PILLILILLIDAAL ILL EDAPLALALLILADD EDAD ADE 22 FQMODE 
Se Se re + 
25 | flag word | 24 FQFLAG 
Se Henne ee ee ee ee ee eee + 
27 SEES MLE SCRA LA RSA AEE ASL 26 
Se ee + 
31 | device name ere. file is (disk) | 30 FQDEV 
Se Se + 
33 |#0, unit number real | device unit number | 32 FQDEVN 
Se Se + 
35 LEAL MAC SUMED KOHLI LESSEN GES RANA A ELLE 34 
Se + 
37 VL aaaaaddaadidda 36 
i + 
FIRQB+FQSIZ The requested device name. Permitted values are LP, 


FIRQB+FQBUFL The device unit real flag. If zero, it means use the 
default print or batch queue. If nonzero, it means use 


BA, and zero which translates to "LPO:." 


the queue with the same name as the device name. 
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You can set the following bits for PBS: 
Bit Meaning When Set 
2 Delete after spooling; same as DCL command 
PRINT/DELETE. 
5 No header; same as DCL command 


PRINT/NOFLAG_ PAGES. (Ignore for batch requests.) 


13 Route request to OPSER spooler 


14 Route request to PBS 


If both bits 13 and 14 are set, then the request is 


routed to PBS. If both bits are clear, then the 
following rules apply: 


o If the spooler device name is "LP" or null, or 


device name is "BA" and the file type is .COM, 
the request is routed to PBS if it is running; 
otherwise, it is routed to OPSER. 


o If the spooler device name is not "LP" or null, 


then the request is routed to OPSER. 


You can set the following bits for OPSER: 


Bit Meaning When Set 

0 The file is spooled with FORTRAN carriage 
control; same effect as QUE/TYP:FTN. 

x Restart file; same effect as QUE/RE. 

2 Delete file after spooling; same effect as 
QUE/DE. 

3 Binary file; same effect as QUE/BI. 

4 The end; same effect as QUE/END. 

5 No header; same effect as QUE/NH. 
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Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.SPL 
subfunction does not return any meaningful data. 


Errors 

DEVNFS The device specified at FIRQB+FQDEV of the call is not 
a file-structured device. 

HNGDEV This error is caused by a hardware condition. For 
example, the specified disk could not be accessed. 

NOBUFS System buffers are not currently available to store 
this message. This may be a transient condition; retry 
the operation. 

NODEVC An attempt was made to queue a file to a device that 
had a unit number greater than seven, or the file to be 
queued is on an invalid device. 

NOROOM The number of messages pending for the queue manager 
program is at its declared maximum. This may be a 
transient condition; retry the operation. 

NOSUCH The account specified at FIRQB+FQPPN does not exist on 
the device specified, the file name or type specified 
at FIRQB+FQNAM1 cannot be found. 

NOTMNT The specified disk device is not mounted. 

PAKLCK The specified disk is restricted, and the caller does 
not have DEVICE privilege. 

PRVIOL An attempt was made to queue a file to which the user 
did not have read access or to queue an executable 
file. 
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 UU.STL (Stall/Unstall System) 


Privileges 


Required 


HWCTL is required to stall or unstall a system. 


Data Passed 


Mne- Octal 


monic Offset 


1 


FQFUN 3 


37 


FIRQB+FQFIL 


Octal 


state. 


0 


2 


Mne- 


FOFIL 
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Offset monic 


Zero means return the system to normal (unstalled) 


One means Stall; suspend all currently active jobs 


except for the calling job. 
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Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.STL 
subfunction does not return any meaningful data. 


Errors 
BADFUO You specified unstall, but the system is not stalled. 
INUSE You tried to stall the system, but it is already 


stalled. 
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UU.SWP (Add, Remove, and List System Files) 

Privileges Required 

INSTAL is required to add or remove system files. File read access 
(by protection code, or GREAD or WREAD privilege) and file write 
access (by protection code, or GWRITE, WWRITE, and/or SYSIO privilege) 
is required to add system files. WRTNFS is required to add 


non-file-structured swap space. 


Data Passed - Add System File 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Sr Se + 
L|YSASAAIIIAIIAIIIIA AAAS AAAS AAA AAAS AAS AA 17/\ 9 
5 el tener ee ee eee ee ee eee eee + 
FQFUN 3 | UU.SWP (= 27) VAAL he 
tenn reer ee eee ee ee eee Henne eee ee ee ee eee eee + 
FQSIZM 5 | = 1 for add | file to add | 4 FQFIL 
Sl Se. + 
VAAL hhh 
t--- eee ee ee ee ee ee ee eee Henn re ee ee ee eee eee + 
11 | for [0,1] file with type of .SyYS, | 10 FQNAM1 
+ file name as 2 words RAD50. If both + 
13 | words = 0, non-file-structured disk. | 12 
tee eee ee eee eee eee eee Herre eee ee ee ee ee eee + 
15 CAESAREAN EAA RA ERED GE ARMA RS A Sele 14 
Si ec + 
17 I PLLLLYISLLSPALLA LLY LPP AAPL A ALT SLAALATLE 16 
Slt terre eee ee eee eee + 
2L VSSSIAIIIIIIAAIIA AAAI ASAIO IAAI AAAS A117 \ 20 
torre te eee eee eee tone ere ee ee ee ee eee eee + 
23 Wee 22 
Se ee + 
25 Vdd 24 
Se + 
27 Wa 26 
Henne eee ee ee eee ee tenn eee ee ee ee ee eee eee + 
31 | ae ice name (disk) (2 ASCII characters) | 30 FQDEV 
i Sr + 
33 |#¥0, unit number real | device unit number | 32 FQDEVN 
Di tener ee ee eee ee ee eee eee + 
BS |SAAIASIIAIASAIIAAI AAA AAAS AAAS AAA AS11477 \ 34 
Sal t--- eee ee ee eee eee + 
37 WO Ee 36 
ie + 
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FIRQB+FQOFIL 


Data Returned 


The possible bit settings are: 
Bit Meaning 

0 Swap file 0 

1 Swap file l 


2 Illegal (generates an error; 
slot 2 is always added) 


3 Swap file 3 


4 Overlay file 
5 Error message file 
6 DECnet/E system file 


Except for a possible error in byte 0 of the FIRQB, the add option of 
the UU.SWP subfunction does not return any meaningful data. 


Errors 


BADFUO 


BADNAM 


DEVNFS 


FIEXST 


INUSE 


NODEVC 


The number specified at FIRQB+FQFIL is either two or is 
greater than six. The swap file 2 must exist on the 
system disk and cannot be added during timesharing. 
System files to be added are defined only by the values 
0, 1, 3, 4, 5, and 6. 


No file name is specified when an overlay, an error 
message, Or a DECnet/E system file is being added, or 
the name specified contains nonalphanumeric characters. 


The device specified is not a disk device. 


The system file being added is already installed on the 
system. 


A swap file is being added to a non-file-structured 
disk, but the disk is currently mounted (that is, it is 
being used as a file-structured device). 


The device specified is a disk but is not on this 
system. 
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NOSUCH 


NOTAVL 


NOTMNT 


PRVIOL 
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If an overlay or error file is being added, this error 
indicates that the file is not long enough. (The 
overlay file should be at least 128. blocks and the 
error file at least 16. blocks.) If a swap file is 
being added to a file-structured device, this error 
means that the file is not long enough to store even 
one job. 


A system file is being added to a file-structured disk, 


but the file with the name specified and with a .SYS 
file type does not exist in account [0,1]. 


A swap file is being added to a non-file-structured 
disk, but either the disk unit or its controller has 
been disabled. The system manager must use an 
initialization option to enable the unit or its 
controller. 


A system file is being added to a file-structured disk 
but that disk is not currently mounted. Use the MOUNT 
command to logically mount the disk before the file is 
added. 


A system file is being added to a file-structured disk. 


Either the unit is logically write locked, or the file 
specified is bad; that is, it is not contiguous or is 
currently open. 
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Data Passed - Remove System File 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
per er eee ee ee eee eee teen eee rt ee ee ee ee eee + 


1 ee, 0 


FOFUN 3 | UU.SWP (= 27) VYIPLILISLILLILLTLL ID | 2 
Herren eee ee eee far c rrr eee + 


FQSIZM 5 | = 0 for remove | file to remove | 4 FQFIL 
Horst rete eee eee eee terre eee ee eee eee eee + 


7 ER Re" 6 
11 YL PPLLLLILIL ILI LAID AL EPIL ILI LT AVAL TL ILIL TDD 10 


Hence ee eee eee Herr eee ene eee + 


13 ELE AIEEE Cle AEAL LRU ALNEE BAG ANA GEM 12 


31 LLILILILILILILT ITAL ILI ILILTET ADELA 30 


pert ee ee eee eee pment ee eee ee eens + 


33 OEE IAG LILLE REL CLL 32 


3-458 


FIRQB+FOFIL 


Data Returned 
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The possible bit settings are: 
Bit Meaning 
0 Swap file 0 
1 Swap file l 


2 Illegal (generates an error; 
slot 2 is never removed) 


3 Swap file 3 

4 Overlay file 

5 Error message file 

6 DECnet/E system file 


Except for a possible error in byte 0 of the FIRQB, the remove option 
of the UU.SWP subfunction does not return any meaningful data. 


Errors 


BADFUO 


INUSE 


PRVIOL 


The number specified at FIRQB+FQFIL is either two or 
greater than six. The swap file 2 must exist on the 
system disk and cannot be removed during time sharing. 
System files to be removed are defined only by the 
values 0, 1, 3, 4, 5 and 6. 


The swap file to be removed can be properly removed but 
currently contains one or more swapped out jobs. The 
system locks the file and begins swapping jobs to other 
files. Retry the call at a later time when the swapped 
out jobs are no longer in this file. 


A swap file is to be removed but its removal decreases 
the swap file space below the limit required to store 
the maximum number of jobs on the system. To remove 
the swap file, decrease the number of logins currently 
allowed (by either the SET LOGINS command or SYS call), 
wait until the number of logged in jobs falls to the 
maximum, and try the removal operation again. This 
error also occurs if you attempt to remove the DECnet/E 
system file when DECnet/E is still on. . 
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Data Passed - List System File 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
te ee ee pee ee ee eee eee ee + 
1 Wd 0 
-=—s ses =e ereeewseweeeneneeseeeeeks ewe we ewsweweeweunseeweees so + 
FQFUN 3 1 UU.SWP (= 27) V/SL/SSILLTILYLLI LIL LD 2 
tence ee ee ee ee ee ee ee eee tence eee ee ee eee eee + 
FQSIZM 5 | = -1 to list | file to list | 4 FQFIL 
i + 


FIRQB+FQFIL The possible bit settings are: 
Bit Meaning 


0 Swap file 0 

1 Swap file l 

2 Swap file 2 

3 Swap file 3 

4 Overlay file 

5 Error message file 

6 DECnet/E system file 
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Data Returned - List System File 


Mne- Octal 
monic Offset 


Errors 


BADFUO 


NOSUCH 


1 


3 


FIRQB 


| project number i programmer number | 
tenner ee ee ee ee eee eee Here ee ee ee eee eee + 
| file name in RAD50 format | 
+ (2 words) + 


terre ee ee ee ee ee ee eee terre ee ee ee ee eee ee eee + 
| file type in RAD50 format (1 word) | 
Se Sr + 


OO 


Octal 
Offset monic 


0 

2 

4 

6 
10 
12 
14 
16 
20 
22 
24 
26 
30 
32 
34 


36 
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Mne- 


FQPPN 


FQNAM1 


FQEXT 


FQODEV 


FQDEVN 


The number specified at FIRQB+FQFIL is less than zero 


or greater than six. 


The number specified at FIRQB+FQFIL refers to a file 


that is not currently installed. 
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UU.SYS (Return Job Status Information) 

Privileges Required 

JOBCTL is required to read the status of another job, except a job 

running on a pseudo keyboard controlled by the caller. TUNE is 

required to obtain priority or run burst status. 

Data Passed 

Mne- Octal Octal Mne- 

monic Offset Offset monic 
ALAA hhh hhh 

FQFUN 3 | UU.SYS (= 32) WALA AAA 


FQOSIZM 5 | subcode= QO, 1, or 2 | job number or 0 | 4 FQFIL 
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Data Returned (for subcode = 0) 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Horne eee ee eee eee eee toe e eee ee ree ee eee eee + 
LYSSSSSSASIIAAAIAAAA AAA AAA AA AAA AAA AAA AS16177 \ % 
ten nee eee ee ee eee eee Se + 
SYSSSSSSIIIS1111111////\ calling job no. * 2 | 2 FQJOB 
Se er + 
FQSIZM 5 | job’s console KB no.| status job no. * 2 | 4 FQFIL 
ee Hern ee ee ee eee eee + 
7 | swap slot location | (ctrlg job no.*2)+1 | 6 FQPPN 
Here re ee ee ee eee ee eee Se + 
Le ;;| LSB of CPU time, in .1 seconds | 10 FQNAM1 
Sl Ss + 
13 | job’s current connect time, in minutes | 12 
terre ee ee ee ee ee eee re + 
15 | LSB of KCTs | 14 FQEXT 
Sr i + 
17 | job’s accumulated device time, minutes | 16 FQSIZ 
tenner ee ee eee eee eee re + 
21 | MSB of CPU time | MSB of KCTs | 20 FQBUFL 
torr ee ee ee ee eee eee SS + 
23 | job name in RAD50 format | 22 FQMODE 
+ (2 words) + 
25 | | 24 
Se tener er ree ee ee eee eee + 
FQPROT 27 | project number | programmer number | 26 FQPFLG 
tener er eee eee eee eee terre er ee ee ee ee eee + 
31° | job keyboard monitor in RADS50 format | 30 FQDEV 
+ (2 words) + 
33 | | 32 
torr ee eee ee ee eee eee Herre ee eee ee eee eee + 
35 | current run-time system in RAD50 format | 34 FQCLUS 
+ (2 words) + 
37 | | 36 
Herr re ee ee ee eee eee ten eee ee ee eee eee + 
FIRQB+FQSIZM If this value is negative, the job is detached, and the 


FIRQB+FQPPN 


value is the one’s complement of the keyboard number to 
which the job was previously attached. 


Returned only if job is attached to a pseudo keyboard. 
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Data Returned (for subcode = 1) 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herre ee eee ee ee eee eee tere eee ee eee eee eee eee + 
1 VL addddddaaiiidla 0 
Se oe cs + 
3 Vaasa calling job no. * 2 | 2 FQJOB 
a + 
FQSIZM 5 | job’s console KB eat status Jee no. * 2 | 4 FQFIL 
Sr i + 
a current flag word | 6 FQPPN 
a te - ne ee ee ee ee eee eee + 
ll | curr. info. posting | eurrent. IOSTS | 10 FQONAM1 
Se Sl + 
LS current JBSTAT word ee” 
tener er ee eee ee eee eee tener ee ee eee ee ee ee eee + 
15 | current JBWAIT word | 14 FQEXT 
tener eee ee ee ee eee eee terre ree eee eee eee eee + 
17 | mem. ctrl sub-block | size, in K words | 16 FQSIZ 
t---- eee eee eee eee eee tee eee ee ee eee ee eee + 
21 {current physical addr., 32-word neretonts | 20 FQOBUFL 
St Sl + 
23 | run burst,in .1 sec | ae vonite | 22 FQMODE 
Sn Se + 
25 | value at offset 6 | max. memory size | 24 FQFLAG 
Horne eee eee ee eee eee teen ee ee ee ee eee eee + 
27 | (depends on JBWAIT and JBSTAT) | 26 FQPFLG 
Henne eee eee ee ee eee eee Herne ee ee ee eee eee + 
31 | read or write state | 30 FQDEV 
t-- eee eee eee eee eee SS + 
33 | pointer to Job Data Block | 32 FQDEVN 
tence eee ee eee ee eee eee tone e er ee eee ee ee eee + 
35: | pointer to second Job Data Block | 34 FQCLUS 
Heer ee eee ee eee eee eee ten re ee er ee ee eee eee + 
37 | pointer to first Receiver ID Block | 36 FQNENT 
Herne ee eee ee ee eee tec ere ee ee ee eee ee eee + 
FIRQB+FQSIZM If this value is negative, the job is detached, and the 
value is the one’s complement of the keyboard number to 
which the job was previously attached. 
FIRQB+FQMODE Returned only if the caller has TUNE privilege. 
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Data Returned (for subcode = 2) 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herne re eee ee ee eee eee Heer ee ee eee ee eee ee eee + 
1 AEE SEAM E REIS SG CABAL A AAG 0 
Se oe i a ior + 
3 WZ calling job no. * 2 | 2 FQJOB 
a ee ed + 
FQSIZM 5 1 job’s console KB no. H status job no. * 2 | 4 FQFIL 
Se tee ee eee ee ee eee ee eee + 
7 |job’s current D-space|job’s current I-space| 6 FQPPN 
t-- ee ee ee ee ee eee eee tener er ee ee ee ee ee eee + 
11 | | 10 FQNAM] 
+ job’s current privilege mask + 
13 | | 12 
+ (4 words) + 
15 | | 14 FQEXT 
+ + 
17 | | 16 FQSIZ 
Se tener eee ee ee ee eee ee eee + 
21 UMA SA AeA ele job’s access type | 20 FQBUFL 
mee ee ee ee ee ee eee Se 
23 Wee 22 
Hen rr ee ee ee ee ee ee ee ee eee eee + 
25 EEL LL EL | 24 
Se ee a i + 
27 WZ aadadadaadidiia 26 
i i + 
31 A PLLLILLILLLTLPLPPLLSLIPDASSLTPPPEPTIPI TIDE 30 
tan en re ee ee ee ee ee ee ee eee eee + 
33 EAE GEREN KGAA RE MALMO LAI ASMER 32 
i ee + 
35 SP PLPLIPLELLILPALPLLPLPPAPPLPSLALYAAPLAP DELS 34 
Harn rr ee ee ee eee ee ee eee eee + 
ST SSAA AI AAAI AIA AAAI AAA AAA AAA AAA AAA AAAS A171 \ 38 
a tect er eee ee ee ee ee ee eee + 


FIRQB+FQSIZM If this value is negative, the job is detached, and the 
value is the one’s complement of the keyboard number to 
which the job was previously attached. 


FIRQB+FQPPN The monitor returns the job’s current I-space size in 
FIRQB+FQPPN and the job’s current D-space size in 
FIRQOB+FQPPN+1. 


FIRQB+FQNAM1 The monitor returns the job’s current privilege mask in 
four words beginning at FIRQB+FQNAM1. 
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FIRQB+FQBUFL 


Errors 


BADFUO 


PRVIOL 


The monitor returns the job’s access type in this byte. 
The following values are defined: 


Value Meaning 
0 Local 
1 Dial-up 
2 Batch 
4 Network (SET HOST) 
6 Network server 


All other values are reserved. 


The job number specified at FIRQB+FQFIL is less than 
zero or greater than JOB MAX. 


The job specified at FIRQB+FQFIL does not exist. 
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UU.TBl (Get Monitor Tables, Part I) 


Privileges Required 


None 


Data Passed 


Mne- Octal 
monic Offset 


1 
FOFUN 3 
5 
7 
ll 
13 
15 
17 
21 
23 
25 
27 
Be 


33 


| UU.TB1 (= -3) VILILILTILIL ILL LL TLE 


Harr rceeeeeeeeeeeeeee peer eee ee eee eee enews + 


gO PEO 


QE 


Herter ee eee eee eee eee Herre eee ee eee ee ee eee + 


LEI LTA LETTE ETE} 


ere epeeeeeeeenrweeeeeee ee were eeeeewry wF fF w@ w= we we eeeeewe we 
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Octal 
Offset monic 


0 


2 


Mne- 


-UU0 
UU.TB1l 


.UU0 
UU.TB1 


‘Data Returned 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herre ene ee ee eee eee eee Herre eee eee ee eee eee eee + 
AMAA 
3 BILD euecane job no. * 2 1 2 FQJOB 
FQSTZM 5 | MAXCNT(max. job no.)|CNT.KB-1(max. KB no.)| 4 FOFIL 
7 | (DEVCNT) address of max. unit no. table | 6 FOPPN 
11 | (DEVPTR) address of pointers to dev. DDBs | 10 FONAMI 
13 |(MEMLST) root link word in lst mem ctl sbik) 12 
15 | (JOBTBL) address of the job table | 14 FOEXT 
17 | (JBSTAT) address of job status table | 16 FQszz 
21 | (JBWAIT) address of job wait flag table | 20 FOQBUFL 
23 | (UNTCLU) addr of unit owners/pk cl sz tbl | 22 FQMODE 
25 | (UNTCNT) address of disk status table | 24 FOFLAG 
27 | (SATCTL) address of free-block table | 26 FQPFLG 
31 |(JSBTBL) adr of job stat ordered by drv idx) 30 FQDEV 
33 | (SATCTM) addr of free block count table | 32 FQDEVN 
asi | cuccent date dn. system internal format | 34 rOcbUS 
37 | (UNTOPT) addr of unit option table | 36 FONENT 
torre eer ee ee eee eee eee Hence e re eee eee ee eee eee + 


FIRQOB+FQCLUS System internal format for date is: 
[(year - 1970) * 1000.] + day-within-year 
Errors 


No errors are possible with UU.TB1. 
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_UU.TB2 (Get Monitor Tables, Part II) 


Privileges Required 


None 


Data Passed 


Mne- Octal 
monic Offset 


1 


FOFUN 3 


per errr eee ee eee eee eee Sr + 
WALA hhh hh 


| UU.TB2 (= -14) WALLA hhh 


Hrs eee ee eee eee eee Herre e eee ee ee eee eee + 


Ueddaaadidda 


GEE 


Horr eee eee eee eee Se + 


Wn eG ey 
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Octal 
Offset monic 


0 


2 


Mne- 


-UU0 
UU.TB2 


-UUO 
UU.TB2 


Data Returned 


Mne- 


monic Offset 


Errors 


Octal 


1 


3 


5 


No errors 


FIRQB 
Octal 
Offset 
t---- ee eee eee ee ee ee eee terre ee eee eee ee eee eee + 
AMM ANA CEASA RAL ALN AA MAE ACK U 0 
Se es + 
PLPILLISTILILLILILT | current job no. * 2 | 2 
terre ree ee ee eee ee ee eee Se + 
| (FREES) addr of free buffer info table | 4 
Sa tee ere ee ee ee ee ee ee eee + 
| (DEVNAM) addr of device name table  -6 
SS tee ee ee eee ee eee eee eee + 
| (CSRTBL) addr of CSR table | 10 
tee eee ee ee eee eee ee eee Se + 
| (DEVOKB) no. disks in DEVNAM * 2 | 12 
a terre re ee ee eee eee eee + 
| (TTYHCT) no. hung term errs since startup | 14 
terre ee ee ee eee eee Se + 
| (JOBCNT) no. jobs now/no. logins allowed | 16 
Se tern ere eee ee eee eee + 
| (RTSLST) rt. lnk.word in RTS dsc.blk.list | 20 
tenn eee ee eee ee ee eee Se + 
| (ERLCTL) error logging control data | 22 
Se t--- eee ee eee ee ee ee eee + 
| (SNDLST) list of are ee msg. rec. jobs | 24 
Se oe es + 
| (DSKLOG) ark logical table | 26 
Henne ee ee ee ee eee eee tere ee ee et ee eee eee + 
| (DEVSYN) start of synonym names in DEVNAM | 30 
Se +----- eee ee eee ee eee + 
| (MEMSIZ) physical memory size, K-words*32 | 32 
Ss te -- eer eee ee eee eee + 
| (CCLLST)root link word of CCL desc. blks. | 34 
ten reer ere ee eee eee ten eee ee eee ee eee eee + 
| (FCBLST) addr of table of roots of FCBs | 36 
tence ee ee ee ee eee eee eee tee eee eee ee eee eee eee + 


are possible with UU.TB2. 
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Mne- 
monic 


FQJOB 
FQFIL 
FQOPPN 


FONAM1 


FQEXT 
FQSIZ 
FOBUFL 
FOMODE 
FOFLAG 
FOPFLG 
FQODEV 
FQODEVN 
FOCLUS 


FQNENT 


UU.TB3 (Get Monitor Tables, 
Privileges Required 

None 

Data Passed 


Mne- Octal 
monic Offset 


Part III) 


Octal 
Offset monic 


i Te AEC Oe 
FQFUN 3 | UU.TB3 (= -29) VWILILIITILILILILT LLU L 
a AAA 
7 a GO fete Me Ge 
11 Vad 
13 Vaaddaddadadidida 
15 VL 
17 ALLELE 
21 OT OG 
23 UZ 
25 I LPLLILILILI LED IL ILIA LILI ILILV ITAL TLD 
va MV AMAA hhh hhh 
SLUSSSSSASAIISSIASAAA SISA ASAT A AAA AAAS ASS | 
33 Te ne as 
35 Veda 
37 GEE 
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0 


Mne- 


-UU0 
UU.TB3 


-UU0 
UU.TB3 


Data Returned 


FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
terre eee eee eee terre re ee eee eee + 
VAL 
SIV/IIIIIILITIIVIIII/\ Sareent job no. * 2 | 2 FQIOB 
5 | (DDCTBL) addr of controller/device table | 4 FQFIL 
7 | (UCTTBL) addr of unit/controller table | 6 FOPPN 
11 | (SATEND) addr of disk size table | 10 FONAM 
13 |(UNTLVL) addr of disk structure level table| 12 
15 | (MEDPTR) addr of MFD point table | 14 FOEX? 
17 |(NAGLBL) addr of mag tape labeling default | 16 Fgszz 
21 WIIIIIHIVITII/IT/\ 20. jobs on system | 20 FOBUFL 
LVL 
25 | (DSTPTR) address of disk statistics table | 24 FOFLAG 
at Pidvere contigs -suienwerd | 26 FOPFLG 
31 |(UNTERR) address of unit error count table | 30 FQDEV 
33 |(DEVCLU) addr of unit dev cl sz/el fac tbl | 32 FODEVN 
35 | (NULRTS) address of NULL RTS block | 34 FOCLUS 
37 WLLL 36 


FIRQB+FQFLAG The Memory Management Unit (MMU) address of the disk 
statistics table, if this monitor was generated with 
the unsupported disk statistics feature. Otherwise, 
FIRQB+FQFLAG is zero. 
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FIRQB+FQPFLG Flag word bit settings indicate hardware configuration 
attributes: 


Bit 


5 


10 


13 


Errors 


Setting 
Clear 
Set 
Clear 
set 
Clear 
Set 
Clear 


Set 


Meaning 
Unibus system 
QBUS system 
FPP not available 
FPP available 
CIS not available 
CIS available 
System does not have I/D space 


System has I/D space 


No errors are possible with UU.TB3. 
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UU.TRM (Set Terminal Characteristics) 
Privileges Required 


HWCFG is required to set a terminal other than the caller’s own, or to 
set permanent characteristics. 


Data Passed (subfunction= 0) 

Mne- Octal Octal Mne- 
monic Offset Offset monic 
LOUSSIASIAIISIITII SAIS IASI SASS S IIASA AAAS 1117 | 9 

FQFUN 3 | UU.TRM (= 20) WALA 

FOSIZM 5 |377(current) or KB no| subfunction code =0 | 4 FQFIL 
7 |200(tab)/377(no tab) | width: 0 or width+l | 6 FQPPN 
ll |200(lwe out)/377(no) |200(no frm) /377( form) | 10 FQNAM1 
13 |200(fdplx)/377(1local)|200(no XON)/377(XON) | 12 
15 | 200(no)/377(lwe in) |200(no scp)/377(scp) | 14 FQEXT 
17 | rcv baud rate [FILL fctr+l;l(noFILL)| 16 FQSIZ 
oA: «| xmt baud rate | PARITY;1(no)2(e)3(0d)| 20 FQBUFL 
23 | 200(*)/377(no ~) |200(no st1)/377(stl) | 22 FQMODE 
25 | parameters \LSISISSS SSSI S111 17/7 \ 24 PQFLAG 

FQPROT 27 |200(no)/377(esc seq) | PERMANENT flag | 26 FQPFLG 
31 |200(no esc)/377(esc) | private Seliniter | 30 FQDEV 
33 |RSUM;200(°C)/377(any)| 200(no * R/377(" R) | 32 FQDEVN 
35 |200(no GAG)/377(GAG) |BRAK; 200(nul)/377(7 C)| 34 FQCLUS 
37 EAI EE ASRS AG SEDI EERE NMA AA Lhe 36 


FIRQB+FQEXT Setting No Scope automatically sets No Stall. 
Setting Scope automatically sets Stall. 
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FIRQB+FQSIZ+1 Receiver baud rate is set as follows: 


0 


n 


No change 


The internal code to determine the baud rate at 
which the terminal receives characters. If 
FIRQOB+FQBUFL+1 is zero, this code also determines 
the transmit (output) baud rate. (Requires HWCTL 
privilege.) Note that you can set internal codes 
only for DH11, DZ11/DZ2V1l, and DHU11/DHV11 
interface lines as follows: 


DH11 DZ11/Dz2V11 DHU11/DHV11 
Code Speed Code Speed Code Speed 
1 0 ut 0 1 0 
2 50 2 50 2 75 
3 (es 3 15 3 110 

4 110 4 110 4 134.5 
5 134.5 5 134.5 5 150 
6 150 6 150 6 300 
7 200 7 300 7 600 
8 300 8 600 8 1200 
9 600 9 1200 9 1800 
10 1200 10 1800 10 2000 
11 1800 11 2000 piel 2400 
12 2400 12 2400 12 4800 
13 4800 13 3600 13 Res. 
14 9600 14 4800 14 9600 
15 7200 15 19200 
16 9600 


FIRQOB+FQBUFL Parity and 8-bit mode values: 


OO fr WN KE 


2 
3 


No parity 

Even parity 

Odd parity 

Enable parity characteristic 
8-bit characteristic off 
8-bit characteristic on 


FIRQB+FQBUFL+1 Transmitter baud rate is set as follows: 


0 


Both the receive (input) and transmit (output) 
speeds are determined by the value n in 
FIRQB+FQSIZ+1. 


The internal code to determine the baud rate at 
which the terminal transmits characters when a 
split speed setting is used. (HWCTL privilege 
required.) You can use split speed settings only 
with the DH]11 interface line. 


3-475 


-UU0 
UU. TRM 


FIRQB+FOQFLAG+1 Value=10+DATA+STOP+PARITY 


where: 
DATA is’ 0 for 5-bit characters 
1 for 6-bit characters 
2 for 7-bit characters 
3 for 8-bit characters 
STOP is 0 for 1 stop bit per character 
4 for 2 stop bits per character 


or 1.5 bits if DATA = 0 


PARITY is 0 for no parity bit 
20 for even parity format 
60 for odd parity format 


This byte applies only to interfaces that support 
DATA/STOP/PARITY features. When this byte is used with 
these interfaces, it overrides the setting of 
FIRQB+FQBUFL. In addition, when this byte is used, 
FIROB+FQSIZ+1 (receiver baud rate) must be nonzero. 


FIRQB+FQPFLG The PERMANENT flag is as follows: 
0 No change 
200 Return permanent characteristics 
377 Set permanent characteristics 
FIRQB+FQDEV Determines the use of private delimiters as follows: 
0 No change. 
200 Disable (clear) the private delimiter. 
200+n Set the private delimiter to ASCII code n (in the 
range 1 to 127). If the character has a special 
meaning (for example, horizontal tab or the 


CTRL/Z combination), the private delimiter usage 
has higher precedence. 
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UU.TRM 
Data Returned (Current Keyboard Characteristics) 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tee ee ee ee ee eee ee eee torre eee eer ee eee eee eee + 

1 URE RELATES EMEME LAE SEE AMEE LAA LEU RAMS 0 

3 VSTILILIELILILLILIDT | current job no. - 2 | 2 FQJOB 
rostzm 5 |255(current) or KB no; KB status | 4 FOFIL 

7] tabsno tab «| width: 0 or width | 6 FOPPN 

11 | le outpt/no lc outpt] no form/form | 10 FOQNAMI 

13 |full dplx/local echo | no XON/KON. | 12 

15 | no le input/lc input| no seope/scope | 14 FOEK? 

17 | receive baud rate | no £411/£i1l | 16 Foszz 

21 | transmit baud rate | no parity/even/odd | 20 FOBUFL 

g3: | Gp attow/no up azrow|, no eteli/ecall  |.220 70NODE 

28 I///IIVIVIVIVIVITIT//| wneertace for line | 24 FOPLAG 
FOPROT 27 | no esc seq/esc seq | PERMANENT flag | 26 FQPFLG 

a) ha eeevece. | delimiter/delim x | 30 FQDEV 

33 |resume CTRL/C or any | CTRL/R,CTRL/T flag | 32 FQDEVN 

35 lenable/dis broadcast |BREAK-null or CTRL/C | 34 FOCLUS 

37 L////IIIIIIIIIIIIII///\8 bit Characteristics] 36 FONENT 

Se 5 i + 

FIRQB+FQFIL Bit 0 when set means the keyboard is disabled or is a 


pseudo keyboard that is not in use. 

When bits 1-6 are clear, it means no job owns the 
keyboard. Otherwise, the value in bits 1-6 is equal to 
the job number times two of the job that owns keyboard. 


Bit 7 when set means the modem line is hung up or is a 
pseuclo keyboard that is not in use. 
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Errors 


BADFUO 


PRVIOL 


The system returns this error for one of two 
possibilities: 


Oo Keyboard number is out of range of valid numbers. 


o Current keyboard is specified but is detached. 


You do not have HWCFG privilege and tried to either: 


o Read the characteristics of a terminal not opened 
Or assigned to your job. 


o Change the characteristics of a terminal other than 
your job’s console terminal (KB:). 


o Change the speed setting for your terminal. 
(FIRQB+FQSIZ+1l or FIRQB+FQBUFL+1 is nonzero.) 


o Set the permanent characteristics for a dial-up 


terminal, pseudo keyboard, or local terminal. 
(FIRQOB+FQPFLG is nonzero.) 
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Data Passed (Subfunction = 1) 


Mne- Octal Octal Mne- 
monic Offset Offset monic 


LVSSSSIIIISIISAISIIII IATA AA IIASA SISA I SSS TS 171 9D 
FQFUN 3 | UU.TRM (= 20) WAAL 


FQSIZM 5 |377(current) or KB no| subfunction code=1 | 4 FQFIL 
Herre ee ee ee eee ee eee teen ee ee ee ee ee ee ee eee + 


TVAASSSIII11111/////////\ terminal type code | 6 FQPPN 


25 LILLY LLL 24 


FQPROT 27 | input buffer quota | PERMANENT flag | 26 FQPFLG 
terre eee eee eee eee eee tee eee eee ee eee ee eee eee + 
31 | clear control chars | set control chars | 30 FQDEV 


33 | set terminal aL ceceemus flags | 32 FQDEVN 
35: | clear terminal ee eae flags | 34 FQCLUS 


37 EAA ESA Ac ha hie SC 36 


FIRQB+FQPPN Terminal type codes. The following decimal values are 
valid; zero causes no change to occur: 


code type code type code type 
no chg 12 LA50 24 LA30 
Unknown 13 VT101 25 VT50 
LA36 14 VT102 26 VT50H 
VT52 15 VT125 27 vT05 
vT55 16 VT131 28 VT0O5B 
LA180S 17 VT132 29 LA30S 
VT100 18 VT220 30 2741 
LA120 19 VT240 31 ASR33 
LA12 20 VT241 32 KSR33 


Ona HRWN FE © 
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FIRQB+FQPFLG 


FIROQB+FQPROT 


FIRQB+FQDEV 


code type code type code type 
9 LA100 21 vTl105 33 ASR35 
10 LA34 22 VK100 34 KSR35 
11 LA38 23 RTO02 
35 Reserved for DIGITAL use 
to 

128 

129 Customer definable 
to 

255 


The PERMANENT flag is as follows: 


0 No change 
200 Return permanent characteristics 
377 Set permanent characteristics 


The terminal’s input buffer quota is as follows: 
0 No change 


6 The maximum number of input buffers. The 
to default value is 6. There are 30 characters per 
255 buffer. The /BUFFER_QUOTA qualifier of the SET 
TERMINAL command sets this characteristic. Users 
need HWCFG privilege to use this feature. 


Note 


There is no guarantee that a terminal can 
allocate its full buffer quota. 


Excessive use of this feature to allocate 
large amounts of buffers to several 
terminals could create a shortage of small 
buffers. 


Setting control character functions or auto-baud. The 
bits currently defined are: 


0 Set CTRL/C 
1 Set CTRL/T 
2 Set CTRL/R 
3 Set CTRL/X 
4 Set autobaud 


Bits can be combined; that is one or more bits can be 
set at any time. If no bits are set, then the current 
setting is unchanged. All other bits are reserved and 
should be zero. 
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FIRQB+FQDEV+1 


FIRQB+FQDEVN 


FIRQB+FQCLUS 
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Clearing control character functions or auto-baud. The 
bits currently defined are: 


Clear CTRL/C 
Clear CTRL/T 
Clear CTRL/R 
Clear CTRL/X 
Clear autobaud 


m WHF © 


Bits can be combined; that is one or more bits can be 
cleared at any time. If no bits are cleared, then the 
current setting is unchanged. All other bits are 
reserved and should be zero. 


Set terminal capability flags. The following bits are 
currently defined: 


Set ANSI escape sequences 

Set advanced video 

Set width to 132 columns 

Set printer port 

Set ReGIS graphics 

Set SIXEL graphics 

Set Katakana character set 

Set selectively erasable characters 
Set dynamically redefinable character sets (DRCS) 
Set user defined keys (UDKs) 

Set local copy 


COMO OAINDU SP WNEF © 


~ 


If no bits are set, the current capability status is 
unchanged. All other bits are reserved and should be 
zero. 


Clear terminal capability flags. The following bits 
are currently defined: 


0 Clear ANSI escape sequences 

l Clear advanced video 

2 Clear 132 column flag 

3 Clear printer port 

4 Clear ReGIS graphics 

5 Clear SIXEL graphics 

6 Clear Katakana character set 

7 Clear selectively erasable characters 
8 Clear dynamically redefinable character set (DRCS) 
9 Clear user defined keys (UDKs) 
10 Clear local copy 


If no bits are set, the current capability status is 
unchanged. All other bits are reserved and should be 
Zero. 


3-481 


-UUO 
UU.TRM 


Data Returned (Current Terminal Characteristics) 


Mne- Octal 
monic Offset 


1 


3 


37 


FIRQB 


VLadddddddddddddda 
WLLL 


WEEE 


tere renee eee ee eee eee tener reer eee eee eee + 


AAA hhh hhh 


WY LILILIILULILTITULITA PERMANENT flag | 


Hartree eee eee eee eee Herren eee eee eee + 


\AIAISIS ISAS AAA 41 /// \carrent ctrl settings | 
| current terminal capability flag settings | 


perenne eee eee eee eee peer ee eee eee eee eee + 


WALLA hhh hhh 
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Octal 
Offset 


6 


10 


12 


14 


16 


20 


22 


24 


26 


30 


32 


34 


36 


Mne- 
monic 


FQPPN 


FOPFLG 
FQDEV 


FQDEVN 


" Errors 


BADFUO 


PRVIOL 


-UUO 
UU.TRM 


The system returns this error for one of three 
possibilities: 


fe) 


.e) 


Oo 


Keyboard number is out of range of valid numbers. 
Current keyboard is specified but is detached. 


The terminal’s input buffer quota is out of range. 


You do not have the required privileges and you tried 
to either: 


oO 


Read the characteristics of a terminal not opened 
or assigned to your job. 


Change the characteristics of a terminal other than 
your job’s console terminal (KB:). 


Change the speed setting for your terminal. 
(FIRQB+FQSIZ+1 or FIRQB+FQBUFL+1 is nonzero.) 


Set the permanent characteristics for a dial-up 
terminal, pseudo keyboard, or local terminal. 
(FIRQB+FQPFLG is nonzero.) 


Change the terminal’s input buffer quota. 
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UU.YLG (Enable Logins) 

Privileges Required 

SWCTL is required to enable logins. 

Data Passed 

Mne- Octal Octal Mne- 

monic Offset Offset monic 
1 SE ESAS ALA AE EEA EEA 0 

FQFUN 3 | UU.YLG (= -1) VWYASIILILLILILLALLITT 2 
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Data Returned 


Mne- Octal 
monic Offset 


1 


3 


Errors 


No errors 


Vad 
LPIPILILILILILTITIT IN current job no. * 2 | 


Henne ee eee eee eee Herne ee ee eee eee eee + 


ASSSTIITSTI111111////\ no. logins allowed | 


Herre eee ee eee eee eee tener eee ee eee eee eee + 


SELLA E SASL EAL LEE EES GAAS 


LPILILLLLILILTLL ULI TLT LL IL AL ILILILTLA LOE 


Here eee eee eee ee eee terre ree eee eee + 


are possible with UU.YLG. 
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Octal Mne- 
Offset monic 


0 
2 FQJOB 
4 FQOFIL 
6 
10 


12 


-UU0 
UU.YLG 


-UU0 
UU.ZER 
UU.ZER (Zero Device) 
Privileges Required 
DEVICE is required to access a restricted device. Create/rename 
access (matching PPN, or GWRITE, WWRITE and/or SYSIO privilege) 
required to zero an account other than caller’s. Set account access 
(GACNT or WACNT privilege) is required to deallocate the UFD when 
zeroing an account. 
Data Passed 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
WAAAY 
FQFUN 3 | UU.ZER (= 15) WAAL 
SLSAASASSSSAS SASS SAS SSS | flag (disk only) | 4 FQFIL 
ee project number | programmer number | 6 FQPPN 
1) | volume ID for label in RADS5O format | 10 FQNAM1 
+ (2 words) + 
13 | (ANSI format mag tape only) | 12 
LS SSAA SAAAAAAA AAA AAA AAA AAA AAAS X14 
17 WOE LI CELLET ET CLIT, 16 
21 WEEE 20 
23 WO CMC COLT Le 22 
25 ILI LLL 24 
27 Uaaadaadadadadiia 26 
31 | device name (disk, ae. or DECtape) | 30 FQDEV 
33 |#0, unit number real | device unit number | 32 FQDEVN 


35 UA EEA LM ES AA AM AEE AE LA LEEM MELAS AREA 34 
37 UZ ddd 36 
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| FIRQOB+FQFIL zero means delete all files except those 
write-protected against owner; retain UFD clusters. 


Minus one means delete all files regardless of 
protection code; release UFD clusters (users with GACNT 
or WACNT privilege only). 


Users without GACNT or WACNT privileges can use this 
flag to delete all files regardless of their protection 
codes, but cannot release UFD clusters. 


FIRQB+FQPPN Users without GACNT or WACNT privilege can specify the 
current account only. Be sure to include the PPN; the 
system returns an error if both bytes are zero. 


Data Returned 


Except for a possible error in byte 0 of the FIRQB, the UU.ZER 
subfunction does not return any meaningful data. 


Errors 
BADFUO No PPN was specified. 
BADNAM The specified device is ANSI magnetic tape, and the 
volume ID is either missing or invalid. 
DEVNFS The specified device does not allow access by file 
name. 
NODEVC The device specified is not on the system. 
NOSUCH The account specified does not exist on the device 
specified. 
NOTAVL The device specified exists on the system, but you 
cannot zero it for one of the following reasons: 
o A file is currently open on the device. 
o The device is currently reserved by another job. 
o The device or its controller is disabled. 
PRVIOL The unit is write-locked, the unit is restricted and 


the caller does not have DEVICE privilege, or the 
caller does not have accounting privileges and 
FIRQB+FQPPN contains a PPN other than the current 
account. 
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UU.3PP (Third-Party Privilege Checking) 


The UU.3PP directive enables or disables third-party privilege 
checking. This directive is for the use of server programs that run 
as a separate job; for example, spoolers. 


Once issued, the directive remains in effect until cancelled by 
another UU.3PP with zero in FIRQB+FQPPN, or by exit from the calling 
program. While in effect, every privilege check done by the monitor 
is made twice: once for the job’s PPN and privilege mask, and once for 
the PPN and privilege mask specified in the call. The function 
proceeds only when the check passes in both cases. 


Privileges Required 


None 
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Data Passed 


Mne- Octal 
monic Offset 


FOQFUN 


FIRQB+FQPPN 


1 


3 


+ 
| 
+ 
privilege mask | 
(4 words) + 
| 
+ 
| 
+ 


Data Returned 


None 


Errors 


NOBUFS 


No small buffers available. 
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Octal Mne- 
Offset monic 


0 

2 

4 

6 FQPPN 
10 FQNAM1 
12 
14 
16 

20 
22 

24 
26 

30 

32 

34 


36 


Specify zero to cancel third-party privilege checking. 


-WRITA 


-WRITA - Write Data to File or Device (Asynchronously) 
Form 

-WRITA 

Function 


The .WRITA directive writes a specified number of bytes of data from a 
user buffer (defined in the XRB) to a file or device currently open on 
a channel. Unless an error occurs, the .WRITA always transfers the 
number of bytes specified. The number of bytes specified must be less 
than or equal to the size of the buffer. Table 3-11 gives specific 
details for each device (see the discussion for the .WRITE directive). 
For comparison, Table 3-11 also shows the "best guess" buffer sizes 
returned by the monitor at FIRQB+FQBUFL when the file or device is 
opened. 


Privileges Required 


EXQTA is required to write in excess of disk quota. TUNE is required 
for asynchronous I/0. 
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, Data Passed 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
1 VALE 0 
<i AA 
5 | completion routine address | 4 FQFIL 
7 | user-supplied parameter | 6 FQPPN 


1 ae Ahhh hhh 


37 AIEEE MK Nig eA hale CAA Seed ede 36 


FIRQB+FQFIL The address in the user job where program flow should 
begin when the asynchronous write completes. 


If this value is zero, no AST completion is executed. 
In this event, it is understood that the user is using 
some other mechanism to determine whether the I/0 
successfully completed. 


FIRQB+FQPPN The user job uses this field to communicate information 


to the AST completion routine. If FIRQB+FQFIL is zero, 
this value is ignored. 
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XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
tee eee eee eee ee ee eee terre ee ee eee eee eee eee + 
1 | length of output buffer, in bytes | O XRLEN 
tere eee ee ee ee eee eee eee terre eee ee eee eee eee + 
3 | number of bytes to be written | 2 XRBC 
tener eee eee ee ee eee eee tener ee eee eee eee + 
5 | starting address of buffer | 4 XRLOC 
tee eee ee eee eee eee eee Heer re ee ee eee ee eee ee + 
XRBLKM 7 | MSB of block number | channel number * 2 | 6 XRCI 
tere ee eee ee ee ee eee ee terre rr ee eee eee eee + 
na LSB of Bree number | 10 XRBLK 
ee rr rr eo + 
13 Veaddddddaddddda 12 
Sn ee + 
15. (4 optional " meattie: | 14 XRMOD 
Se Sr + 
XRB+XRLEN Length of the output buffer, in bytes. The value of 


this word must be nonzero. 


XRB+XRBC The number of bytes to be written. The value of this 
word must be nonzero and less than or equal to the 
buffer size, as specified at offset XRB+XRLEN. For 
disk, this must be a multiple of 512. 


XRB+XRLOC Starting address of the output buffer. For disk, 
flexible diskette, and magnetic tape devices, this 
address must be on a word (even) boundary. For all 
other devices, the buffer can begin on an odd address. 
(See the section "XRB (Transfer Request Block)" in 
Chapter 2 for more information.) 


XRB+XRCI Channel number times two; defines the channel on which 
the data is to-be written, as previously defined in an 
open (OPNFQ, CREFQ, CRTFQ, CRBFQ functions of CALFIP). 


XRB+XRBLKM For disk files, this byte contains the most significant 
bits of the starting block number where the write is to 
begin. This byte is combined with the word at 
XRB+XRBLK to form a 24-bit field. 


XRB+XRBLK Starting block number where the write is to begin. 
Performs the same action as the BLOCK option for disk 
or the RECORD option for flexible diskette and 
non-file-structured DECtape (see the RSTS/E Programming 
Manual). This parameter is ignored if the device is 
not a random-access device. If the device is 
random-access, and this field is nonzero, it is 
interpreted as the block number where the write is to 
start (1 to n, where n is the length of the file in 


3-492 


XRB+XRMOD 


-WRITA 


512-byte blocks). If zero, the next sequential block 
is written. 


For disk devices opened as non-file-structured in 
cluster mode, this value is the starting device cluster 
number where the write is to begin. 


Output operation modifier; significant only for line 
printer, terminal, and DMC/DMR devices. (The monitor 
informs you with the FLGMOD bit of the flag word 
whether or not the device accepts modifiers.) This 
parameter performs the same action as the BASIC-PLUS 
RECORD modifier for these devices (see the RSTS/E 
Programming Manual). 
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Data Returned to Completion Routine 
FIRQB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
LYSASSASSA11S11 111110177 | error code | 0 
3 VMI 90 tuner * 2 | 2 FQIOB 
) WL 4 
7 | user seer parameter i 6 FQPPN 
11 WLLL 10 
13 Vad 12 
15 VZaaaaaaddaadadaiida 14 
17 Veda 16 
21  PLPIPILLILALLILILLALILAULPTLA ELIDA LLTLTID ILE 20 
23 SE RIGA NMSA RACAL AEM NAA EEE AM E Me 22 
(25 Vdd 24 
27 Vad 26 
31 Veaaaaadadaaaadadia 30 
33 PP PLLALLILLLLILILLILILL LTDA ILIAD TDTIL LE 32 
35 We 34 


37 Vad 36 
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XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Heer ee eee ee eee Se + 
1 UZ adddaiiiiiida 0 
Se ee eis + 
a. number of bytes not written | 2 XRBC 
Se ten rrr ee ee ee ee ee eee + 
a AAA hhh: 
terre re tee eee eee Sell + 
XRBLKM 7 | MSB of block number |/Jff/VV/J//J/II1/11/1///\ & 
Sl Herre eee ree ee eee + 
11 | block number where write began | 10 XRBLK 
Slt Se + 
13 Vda 12 
Se as + 
15 PLLLILILL TLL ILA ILA LPALL APA ALTLL ALA AL ALA ILLD 14 
Sl Ss + 
XRB+XRBC The number of bytes not written in this .WRITE 


operation. This value is usually zero. 


XRB+XRBLKM For disk files, the MSB of the block number of the 
block just written. (Combined with XRB+XRBLK to form a 
24-bit field.) 


XRB+XRBLK For random-access devices, this word contains the block 
number of the block just written. Block numbers range 
from 1 to n, where n is the length of the file, in 
512-byte blocks. They define the order in which the 
file is written. 


For disk devices opened as non-file-structured in 
cluster mode, this is the device cluster number of the 
cluster just written. 


Exrors 

BADCNT The completion routine address is invalid or odd. 

BSERR The specified channel number is illegal; that is, it is 
not in the range 0 - 36 (since channel is specified as 
channel * 2), or it is an odd number. 

EOF A write was attempted to a block beyond the end of the 
disk when the disk was opened non-file structured. 

INUSE Too much outstanding I/O for the job (over quota). 

NOBUFS No small buffers were available for the request. 

NOTOPN No device is currently open on the specified channel. 
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PRVIOL 


One of the following occurred: 


o The file or device currently open on the specified 
channel is read-only. 


o The open for this file or device did not specify 
write access. A write was requested that would 
extend a UFD or a contiguous file. 


o A write was attempted that would extend a file in 
special update mode and block 0 was not locked. 


o A write was attempted that would extend an 
executable file, increasing its size to more than 
65,535 blocks. 


All other errors are device-dependent. Common errors are: 


DATERR 


HNGDEV 


NOROOM 


Example 


Some data error occurred. This error is issued when a 
parity error occurs, and so forth. 


Some hard device I/0 error occurred. For example, the 
specified device is off-line, is physically 
write-locked, and so forth. 


No more room is available on the device. For example, 
the end-of-tape marker has been encountered, no more 
available disk space, and so forth. 


See the description of .READA for an example using .WRITA. 
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' ,WRITE - Write Data to File or Device 
Form 

-WRITE 

Function 


The .WRITE directive writes a specified number of bytes of data froma 
user buffer (defined in the XRB) to a file or device currently open on 
a channel. Unless an error occurs, the .WRITE always transfers the 
number of bytes specified. The number of bytes specified must be less 
than or equal to the size of the buffer. Table 3-11 gives specific 
details for each device. For comparison, Table 3-11 also shows the 
best guess buffer sizes returned by the monitor at FIRQB+FQBUFL when 
the device is opened. 


Table 3-1l: Data Output with .WRITE 


tore ee eee eee t+---- eee eee +--- eee ee eee t-- eee ee ee ee ee ee ee ee ee ee ee eee + 
| | Block | "Best | | 
| | Size, | Guess," | | 
| | Bytes | Bytes | Restrictions on Number | 
| Device | (Decimal) | (Decimal) | of Bytes Written | 
Heer ee e eee eee +---- + --- eee Se Heer ee ee ee ee ee ee ee ee eee ee eee + 
| Byte-Oriented Devices (FLGFRC=1, FLGRND=0) | 
too eee eee eee t---- + -- eee +----- ee eee te eee ee ee ee ee ee eee eee ee ee eee + 
| | | | | 
| Keyboard | N/A | 128 | None | 
| (Terminal) | | | 

| | | | | 
| Pseudo | N/A | 128 | None | 
| Keyboard | | | | 
| | | | 

| Paper Tape | N/A | 128 | None 

| Punch | | | 

| | | | 

| Line | N/A | 128 | None 

| Printer | | | | 
Hee ee ee ee ee eee t--- ee ee eee terre eee eee terre ee ee ee eee ee ee eee eee + 
| Block-Sequential Devices (FLGFRC=0, FLGRND=1) | 
+--- eee ee ee eee t---- rere eee +------- eee terre eee ee ee ee ee ee ee ee eee eee + 
| Magnetic | 14 to | 512 | 14 to 32,767 bytes | 
| Tape | 25407. | | | 
| | | | | 
| DECtape | 510 | 510 | Must be < 510 bytes; if < | 
| (file- | | | 510, automatically filled | 
| structured) | | | with NULLs to 510 bytes. | 
| | | | | 
| DMC/DMR | 1 to 8000 | 512 | None | 
tee ee ee ee ee eee +e - eee ee eee +----- eee eee tenn ee ee ee ee eee ee ee eee + 


WRITE 


Table 3-ll: Data Output with .WRITE (Cont. ) 


t--- 2-5 ee ee eee +----------- +-------+---- Se + 
| Block | "Best | | 
| Size, | Guess," | | 
| Bytes | Bytes | Restrictions on Number | 

Device | (Decimal) | (Decimal) | of Bytes Written | 

tanner ee ee ee ee ee eee + 

Block-Random Devices (FLGFRC=0, FLGRND=0) 
a t----- eee +----------- Se + 
| | | | | 
Disk | 512 | 512 | Must be multiple of 512 

| | | | bytes. (Must be 512 if | 
| | | writing UFD.) | 
| | | | 

Flexible | * | 512 | If not a multiple of 

Diskette | | | block/sector size, zero fill | 
| (RX0Ol1l and | | | to end of block/sector. | 
ae : : 
| DECtape | 512 | 512 | Must be < 512 bytes; if < | 
| (non-file- | | | 512, automatically filled | 
| structured) | | | with NULLs to 512 bytes. | 

+------------- t----- eee e ee +------- +e ee 4 


| * 512 (block mode) or 128 


(RX01 or RX02 single-density sector | 


| mode) or 256 (RX02 double-density sector mode) | 


afer 2 ew eo Ee les erarnet Sten See. Site pepe ter = 


Privileges Required 


a + 


EXQTA is required to write in excess of disk quota. 


Data Passed 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
Sl tee ree ree eee ee eee eee + 
i. length of output buffer, in bytes | O XRLEN 
St Se + 
3 | number of bytes to be written | 2 XRBC 
Se 5 + 
4 starting address of buffer | 4 XRLOC 
+--+ - eee eee ee ee eee ee eee St + 
XRBLKM 7 | MSB of block number | channel number * 2 | 6 XRCI 
Sl Herre ee re ee eee eee + 
11 | LSB of block number | 10 XRBLK 
ten ree re ee eee ee eee tere rer ee ee eee eee + 
LS SAIS LISI ILI AAS TALI IIS AAIT AAA ATS TT ATI AT ITIP Ae 
tee ee eee ee eee ee eee peer tree eee ee eee + 
Lo 4 optional modifier | 14 XRMOD 
toner ree eee ee eee eee Se re + 


XRB+XRLEN 


XRB+XRBC 


XRB+XRLOC 


XRB+XRCI 


XRB+XRBLKM 


XRB+XRBLK 


XRB+XRMOD 


-WRITE 


Length of the output buffer, in bytes. The value of 
this word must be nonzero. 


The number of bytes to be written. The value of this 
word must be nonzero and less than or equal to the 
buffer size, as specified at offset XRB+XRLEN. For 
disk, this must be some multiple of 512. 


Starting address of the output buffer. For disk, 
flexible diskette, and magnetic tape devices, this 
address must be on a word (even) boundary. For all 
other devices, the buffer can begin on an odd address. 
(See the section "XRB (Transfer Request Block)" in 
Chapter 2 for more information. ) 


Channel number times two; defines the channel on which 
the data is to be written, as previously defined in an 
open (OPNFQ, CREFQ, CRTFQ, CRBFQ functions of CALFIP). 


For disk files, this byte contains the MSB of the 
starting block number where the write is to begin. 
This byte is combined with the word at XRB+XRBLK to 
Form a 24-bit field. 


Starting block number where the write is to begin. 
Performs the same action as the BLOCK option for disk 
or the RECORD option for flexible diskette and 
non-file-structured DECtape (see the RSTS/E Programming 
Manual). This parameter is ignored if the device is 
not a random-access device. If the device is 
random-access, and this field is nonzero, it is 
interpreted as the block number where the write is to 
start (1 to n, where n is the length of the file in 
512-byte blocks). If zero, the next sequential block 
is written. 


For disk devices opened as non-file-structured in 
cluster mode, this value is the starting device cluster 
number where the write is to begin. 


Output operation modifier; significant only for line 
printer, terminal, and DMC/DMR devices. (The monitor 
informs you with the FLGMOD bit of the flag word 
whether or not the device accepts modifiers.) Except 
for modifier 20000, which is useful to MACRO 
programmers only, this parameter performs the same 
action as the BASIC-PLUS RECORD modifier for these 
devices (see the RSTS/E Programming Manual). 


Modifier 20000 provides a no stall option for line 
printer or terminal output. This modifier causes the 
monitor to return control to your program if an output 
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stall is to occur on the device. You can determine the 
number of bytes still to be written by checking the 
contents of XRB+XRBC. 


Use this modifier for programs that must perform 
several different functions with optimal performance, 
such as a line printer spooler that performs message 
send/receive and prints files at the same time. When 
an output stall does occur, the program can perform 
other processing before trying to write the remaining 
bytes to the line printer or terminal. You may also 
find this modifier useful in multiterminal service 
applications. 


When you use the No Stall option on a line printer, you 
can perform a special test to see whether the line 
printer is busy without causing your program to stall. 
To perform the test, write a null character and set 
modifier bits 2 and 13. When both bits are set, the 
system returns control to your program instead of 
stalling it. The value at XRB+XRBC tells you the 
status of the line printer: 


XRB+XRBC = 0 The line printer buffers are empty; that 
is, there are no characters still to 
print. 


XRB+XRBC # 0 The line printer buffers still contain one 
Or more characters to print. Repeat the 
test until the system returns zero at 
XRB+XRBC. 


For more information on modifier bit 2 for line 
printers, see Appendix B and the RSTS/E Programming 
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Manual. The RSTS/E Programming Manual also contains 
more information on special programming techniques for 
line printers. 


Data Returned 


XRB 
Mne- Octal Octal Mne- 
monic Offset Offset monic 
5 le i + 
1 Vad 0 
Si + 
3. | aanbet of ykeE not written | 2 XRBC 
Horr ee eee ee eee ee +---- 2 ee eee eee eee eee + 
5 "Wedded 4 
. Se + 
' XRBLKM 7 | MSB of BlGek number ee 6 
Sl le + 
11 block number where write began | 10 XRBLK 
torr ree re ee eee eee tee ee eee eee eee eee eee + 
13 Uda 12 
Se ee ee ee + 
L5 SP LLPLPLLPLALPLELLALPLLPLEPLPSLALT TPP ADATLE | 14 
torr ree ee eee eee 5 + 

XRB+XRBC The number of bytes not written in this .WRITE 
operation. Except for terminals and line printers, 
this value is generally zero. 

XRB+XRBLKM For disk files, the most significant bits of the block 
number of the block just written. (Combined with 
XRB+XRBLK to form a 24-bit field.) 

XRB+XRBLK For random-access devices, this word contains the block 
number of the block just written. Block numbers range 
from 1 to n, where n is the length of the file, in 
512-byte blocks. They define the order in which the 
file is written. 

For disk devices opened as non-file-structured in 
cluster mode, this is the device cluster number of the 
cluster just written. 

Errors 

BADCNT The first three words of the XRB that describe the 
output buffer are illegal (an illegal byte count). 

BSERR The specified channel number is illegal; that is, it is 


not in the range 0 - 36 (since channel is specified as 
channel * 2), or it is an odd number. 
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EOF A write was attempted to a block beyond the end of the 

disk when the disk was opened non-file structured. 
NOTOPN No device is currently open on the specified channel. 
PRVIOL One of the following occurred: 


o The file or device currently open on the specified 
channel is read-only. 


o The open for this file or device did not specify 
write access. A write was requested that would 
extend a UFD or a contiguous file. 


o A write was attempted that would extend a file in 
special update mode and block 0 was not locked. 


o A write was attempted that would extend an 
executable file, increasing its size to more than 
65,535 blocks. 


All other errors are device-dependent. Common errors are: 


DATERR Some data error occurred. This error is issued when a 
parity error occurs, and so forth. 


HNGDEV Some hard device I/O error occurred. For example, the 
specified device is off-line, is physically 
write-locked, and so forth. 


NOROOM No more room is available on the device. For example, 
the end-of-tape marker has been encountered, no more 
available disk space, and so forth. 


Example 


The following code writes the contents of a buffer to the file open on 
channel 5: 


MOV #1024.,XRB+XRLEN ;SET BUFFER LENGTH 
MOV #1024.,XRB+XRBC ;SET BYTES TO WRITE 
MOV #BUFFER,XRB+XRLOC ;SET BUFFER ADDRESS 
MOVB #5*2,XRB+XRCI ;SET CHANNEL = 5 
-WRITE 
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PART Ill 

RSX and RT11 
Emulator 
Directives 


Chapter 4: RSX Run-Time System Environment 


Chapter 1 describes the RSX run-time system as emulating the RSX 
operating system environment on RSTS/E. This is only partially true; 
the RSX emulator does not provide a real-time, multiprocessing 
environment to users of a RSTS/E time-sharing system. However, the 
RSX emulator does process directives that are identical in form, and 
Similar in objective, to a subset of the RSX-11M-PLUS monitor 
directives that the RSX-11M/M-PLUS Executive Reference Manual 
describes. 


If you use the RSX directives Chapter 5 describes, you must assemble 
your program with the MAC assembler and link the modules with the Task 
Builder (TKB). The program can then be run as a user job image under 
the control of the RSX emulator (which is part of the RSTS/E monitor). 


Advantage: Transportable Code 


The RSX emulator directives are useful if you are coding a program to 
be run under both the RSX-11M-PLUS and RSTS/E operating systems. 
However, RSTS/E does not emulate all RSX-11M-PLUS executive 
directives, and the meanings of those that are emulated are fitted to 
the RSTS/E environment. 


To design a program to be run under both operating systems, you need 
to know how the directives work under RSX-11M-PLUS and under RSTS/E. 
This manual describes what the directives do under RSTS/E. Some 
comparison is made here to RSX-11M-PLUS, but you must refer to the 
RSX-11M/M-PLUS Executive Reference Manual for a complete description 
of how these directives work in the RSX-11M-PLUS environment. 


Another benefit of using compatible directives is that you can execute 
such programs directly on VAX/VMS under the VAX-11 RSX Application 
Migration Executive (AME), which is similar in function to the RSX 
emulator. AME emulates most RSX-11M-PLUS executive directives. 


General Services 
Besides transportable code, the RSX emulator directives also provide: 


o Non-file-structured I/O -- The RSX emulator directives handle 
only non-file-structured I/O (for example, terminal I/O). 
For this type of I/0, using the directives takes less memory 
than using RMS. See the RSTS/E RMS-11 MACRO Programmer’s 
Guide for a description of the record management service 
capabilities for MACRO programmers. 
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RMS routines are available to MACRO programmers through 
resident libraries or through linking to make them part of 
the user job image. In either case, the RMS routines take 
Space in the job area. The RSX emulator directives that do 
I/O take no extra space, since the code to handle the 
processing is in the monitor. 


o Trap handling -- The RSX emulator includes processing to 
handle synchronous and asynchronous exceptions. Mainly, the 
emulator aborts the program when such exceptions occur and 
prints an error message at the job’s terminal. For some 
directives, you can request that this processing be bypassed 
and handle such exceptions in your program. For example, you 
can specify an address to pass control to when a 
Floating-Point Processor (FPP) exception occurs. 


RSX Directive Emulation Within RSTS/E Monitor 


RSX emulation is a standard feature of the RSTS/E monitor. This 
allows task images to execute without a run-time system, because the 
monitor handles the RSX emulation directly. As a result, task images 
may expand to be as large as 64K-32 words; furthermore, a resident 
library (for example, RMS) may use the address space which would 
otherwise be taken by the run-time system. 


Since RSTS/E jobs are never without a run-time system, the monitor 
associates the job with a zero-length, run-time system called "...RSxX" 
for the duration of the task’s execution. When the task ends, the job 
exits to its default keyboard monitor. 


System Macro Library 


The RSX emulator directives that you code into your program are macro 
calls; they must be expanded into executable code at assembly time. 
The system macro library (LB:RSXMAC.SML) contains the macro expansions 
for the RSX emulator directives. This library file can be named in 
the input-file list when the assembly is done. For example: 


MAC OBJ,OBJ=SRC1,SRC2,LB:RSXMAC.SML/ML 


However, the MAC assembler searches the library automatically to 
resolve undefined symbols, so this is not really necessary. 


In your code, though, you must use the MACRO-11 .MCALL directive to 
define the directives you use as external macros needed to assemble 
the source program. The .MCALL directive must appear before you call 
the first such directive. For example: 
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-MCALL ALUNS ,QIOS 


ALUNS 2,TT,5 


Alternatively, you can use the .ENABL MCL assembler directive to 
enable automatic macro library search. See the PDP-11 MACRO-11 
Language Reference Manual for details. 


Directive Processing 


At assembly time, MAC expands the RSX directives to a code that 
defines the action to be taken and the parameters to be used ina 
Directive Parameter Block (DPB). 


Figure 4-1 shows the general form of a DPB. 


Figure 4-l: General Form of the Directive Parameter Block 


The Directive Identification Code (DIC) in the low byte of the first 
word of the DPB defines the particular function to be performed. The 
RSX emulator examines the DIC to determine what it is supposed to do. 
The high byte of the first word of the DPB gives the length of the DPB 
in words (including the DIC and length byte). The remaining words 
contain parameters; usually these are values specified by the user in 
the directive call, expanded through MACRO-11 data definition macros 
such as .BYTE, .WORD, .RAD50, and so forth. 


The directive expansions also include executable code to tell the 
emulator where the DPB is, an EMT 377 instruction to pass control to 
the emulator and, optionally, transfer control to an error processing 
routine specified by the user. 
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At execution time, RSTS/E pushes either the DPB address or the DPB 
itself on the stack. The choice depends on the form of the directive. 
The EMT 377 instruction passes control to the RSTS/E monitor. The 
monitor recognizes the EMT 377 and passes control to the RSX emulation 
in the monitor. The RSX emulator examines the DPB and processes the 
directive. It then pops the DPB address or the entire DPB off the 
stack and either returns control to the program that executed the 
directive or, if the directive was an exit of some kind, to whatever 
location is appropriate to the exit. 


When control returns in line, the carry condition code in the program 
status word (PSW) indicates that the directive executed successfully 
(carry code = 0) or failed (carry code = 1). The Directive Status 
Word gives more information on the success or failure of the 
directive. You can refer to the Directive Status Word in your program 
with the mnemonic SDSW; TKB defines this variable and resolves its 
location automatically at link time. Other mnemonics are similarly 
related to the possible values of SDSW, so the MACRO programmer can 
test for error conditions using symbols such as IS.SUC for successful 
completion. See "DSW Return Codes" in Chapter 5 for a listing of the 
symbols appropriate to each directive. 


Directive Forms (S$, $C, $S) and Their Expansions 


The library file RSXMAC.SML contains three different expansions for 
each of the RSX-11M directives (see Chapter 5). The form of the 
directive name you use determines which expansion to be inserted in 
your code. Directive names consist of one to four letters, followed 
by a dollar sign ($) and, optionally, aC or an S. 


Figure 4-2 shows an example of the three forms for the ALUNS directive 
(Assign Logical Unit). 
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' Form Your Code Expansion 
S$ A: ALUNS 5,TT,0 Ae .BYTE 7,4 

‘ -WORD 5 
. -ASCII /TT/ 
- -WORD 0 
DIRS #A,ERR MOV #A,-(SP) 
. EMT 377 
; BCC .+6 


‘ JSR PC,ERR 
DIRS #A,ERR ‘ 
(same as above) 


Sc ALUNSC 5,TT,0,PSEC1,ERR .PSECT SDPBS$ 
SSS=, 

.BYTE 7,4 
-WORD 5 
-ASCII /TT/ 
.WORD 0 
.PSECT PSECl 
MOV #SSS$,-(SP) 
EMT 377 
BCC .+6 
JSR PC,ERR 


$s ALUNSS #5,#"TT,#0,ERR MOV #0,-(SP) 
; MOV #"TT,-(SP) 

: MOV #5,-(SP) 
MOV (PC)+,-(SP) 


-BYTE 7,4 
EMT 377 


BCC .+6 
JSR PC,ERR 


Figure 4-2: Example of RSX Directive Forms 


$ Form (and DIR$ Directive) 


Description 


Create DPB in data 
section of program 
(at assembly time) 


Push DPB address 

Call RSX emulator 
Branch if no error 
Go to ERR on error 


(same as above) 


Create DPB at 
assembly time and 
automatically put 
in separate PSECT 
called S$DPBS$ 


Reenter PSECT 

Push DPB address 
Call RSX emulator 
Branch if no error 
Go to ERR on error 


Create DPB at 
execution time and 
push entire DPB 

on stack 


Call RSX emulator 
Branch if no error 
Go to ERR on error 


As Figure 4-2 shows, the $ form of an RSX emulator directive generates 
a DPB inline. The DIRS directive expands to code that pushes the 
address of the DPB on the stack and passes control to the RSX 
emulator. Use the $ form/DIRS$ combination when you want to repeatedly 
execute the same directive. After one directive defines a DPB, as 


many other DIRS directives as need it, can use it. 
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This technique 
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Saves memory. Also, you can modify the individual parameters in the 
DPB when you use the same directive many times with varying 
parameters. 


$ Form 


The $ form of an RSX emulator directive expands to code that defines 
the DPB. The expansions consist of MACRO-11 data storage directives 
(for example, .BYTE, .WORD, .RAD50); they are not executable. 
Therefore, use the $ form of an RSX emulator directive only in a data 
section of your program. 


Finally, use parameters that fit the MACRO-11 data storage directive 
in which they will appear in the expanded code. For example, the 
ALUNS directive expands to the four instructions that follow: 


ALUNS 5,TT,0 
Expansion: 


.BYTE 7,4 
.WORD 5 
.ASCII /TT/ 
.WORD 0 


Although the example uses the two-character second parameter (TT) ina 
MACRO-11 .ASCII directive, you do not need to specify the enclosing 
slashes; the expansion does that for you. 


Note that the first word of the expansion (the first word of the DPB) 
consists of two bytes. The 7 in the low byte is the DIC byte for the 
ALUNS directive. The 4 in the high byte indicates that the DPB is 4 

words long. 


DIR$ Directive 

The general form of the DIRS directive is: 
DIRS [adr] [,err] 

where: 


adr is the address of the first word of the DPB. As shown in the 
following expansion, this address must be a valid source 
address for a MOV instruction. (The adr parameter can be 
omitted. In this case, the entire DPB must be on the stack 
when the DIRS is executed.) 


err is an optional error address. Control passes to this address 
if the directive does not execute successfully. If this 
parameter is omitted, control returns in line with the C-bit 
set in the program status word (PSW). 


4-6 


RSX Run-Time System Environment 


For example, the DIRS directive expands to the four instructions that 
follow: 


DIRS #DPB,ERROR 
Expansion: 


MOV #DPB,-(SP) 
EMT 377 

BCC +6 

JSR PC,ERROR 


RSTS/E pushes the address of the DPB on the stack, and the EMT 
transfers control to the RSX emulator. The emulator processes the 
directive according to the parameters specified in the DPB, pops the 
DPB address off the stack, and (for ALUNS) returns control in line. 
The BCC instruction branches around the JSR to ERROR if the C-bit is 
not set (no error occurred). 


Other Features of $ Form/DIRS Combination 


The $ form of the RSX emulator directives generates local offsets that 
you can use to refer to parameters in the DPB. 


Note 
The expansions use the MACRO-11 .NLIST directive so 
the code that generates these offsets (which is not 
of interest to your program) does not show up in your 
assembly listings. 


For example, in the ALUNS directive, you specify a logical unit 
number, physical device name, and device unit number: 


LN5SDEF: ALUNS 5,TT,0 


When this directive is expanded, it includes code that allows you to 
refer to the parameters as: 


LN5DEF+A. LULU (Logical unit number) 
LN5DEF+A.LUNA (Device name) 
LN5DEF+A.LUNU (Unit number) 


Chapter 5 lists these offset names under "Local Symbol Definitions" 
for each directive. The number of bytes defined for each offset is 
given in parentheses following a description of the area referenced by 
the offset. For example: 


A.LUNU -- Logical unit number (2) 
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(You can also use offset names with the $C form of directives. 
However, you cannot use offset names with the $S form because $S 
generates values that are pushed on the stack.) 


The $ form expansions are also designed so you can use them to simply 
set up the offset symbols to reference a DPB in another module. If 
you define the symbol S$SSGLB in your program (for example, S$SGLB = 0 
will do), the $ form of any directive generates the symbolic offsets 
as global symbols and does not generate the DPB itself. For example, 
suppose another module has the following code: 


MYMY:: ALUNS 5,TT,0 


In the current module, define MYMY as a global symbol, define SSSGLB, 
specify an ALUNS, and you will be able to reference MYMY+A.LULU, and 
so forth. 


$C Form 


If you know the DPB parameters at assembly time and need to issue a 
directive only once, the $C form saves you the trouble of coding two 
directives: the $ form and DIRS. The $C form also saves execution 
time over the $S form, which uses MOV instructions to place the entire 
DPB on the stack and may save space as well. 


The $C form of the directives expands to code that: 
o Defines the DPB in a separate PSECT (called $DPBS$$). 


o Returns to a user-specified PSECT. If no PSECT name is 
given, returns to the blank (unnamed) PSECT. 


o Pushes the DPB address on the stack. 
o Passes control to the RSX emulator. 


o On return, passes control to a user-specified error routine 
if the directive did not execute successfully. If you did 
not specify an error routine, no such code is generated. 


The directive descriptions in Chapter 5 show the form and expansion 
for the $ form. To use the $C form, you must add the C to the 
directive name and, optionally, add a PSECT name and error address to 
the parameter list. For example, the ALUNSC directive expands to the 
ll instructions that follow: 


ALUNSC 5,TT,0,PART1,ERROR 


Expansion: 
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-PSECT SDPBSS 
SSS=. 

. BYTE 7,4 
.WORD 5 

-ASCII 7fTT/ 
.WORD 0 

-PSECT PARTI 
MOV #$$S,-(SP) 
EMT 377 

BCC +6 

JSR PC,ERROR 


MAC places the DPB in a separate PSECT called SDPBS$$. The $$$ symbol 
equates to the address of the DPB, which MAC uses in the MOV 
instruction that pushes the DPB address on the stack before control 
passes to the emulator by the EMT instruction. The last two 
instructions set up the test for error and transfer control to the 
specified error routine. If you do not specify an error address in 
the call, MAC does not generate those instructions. 


Other Features of $C Form 


The offset mnemonics that MAC generates for the $ form are also 
generated for the $C form. Thus, you can save space by using the $$$ 
address to form the base address for the offsets. The $SSGLB feature 
for the $ form also works for the $C form of the directives. 


$S Form 


The $S form is useful if your code is reentrant and the DPB parameters 
vary. RSTS/E generates the DPB when it executes the directive at run 
time. 


The $S form of the directives expands to code that: 


o Generates the DPB at execution time and pushes it on the 
stack. 


o Transfers control to the RSX emulator. The RSX emulator 
checks the low byte of the first word on the stack to 
determine if it is a DPB address (even low byte) or a DIC 
(odd low byte). If the low byte is odd, then the emulator 
knows that the rest of the DPB is on the stack. 
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o On return, passes control to a user-specified error routine 
if the directive did not execute successfully. If no error 
routine is specified, no such code is generated. 


To use the $S form of the directives, add S to the directive names 
shown in Chapter 5. You can also specify an error address as the last 
parameter in the line. For example, the ALUNSS directive expands to 
the eight instructions that follow: 

ALUNSS #5,DEV,UN,ERR 


Expansion: 


MOV UN, -(SP) 
MOV DEV, -(SP) 
MOV #5,-(SP) 
MOV (PC)+,-(SP) 
-BYTE 7,4 

EMT 377 

BCC +.6 

JSR PC,ERR 


RSTS/E generates the DPB at run time and pushes it on the stack. 
Control passes to the RSX emulator, and if control returns with an 
error (the C-bit is set on return), control transfers to the error 
routine. If you do not specify an error address in the call, MAC does 
not generate the last two instructions. 


First 512. Bytes of Low Segment for RSX 


As Chapter 2 notes, the first 512. bytes of virtual address space have 
special meaning to the monitor. TKB, which links programs assembled 
or compiled under the RSX run-time system and its derivatives, 
generates a header for your executable program. When the RSX emulator 
loads your program, it uses information from this header to load 
certain values into the low 512. bytes of your program. 


Table 4-1 shows the allocation of the first 512. bytes of the low 
segment for RSX-type programs. Note that all locations are subject to 
change except for $DSW, KEY, FIRQB, XRB, and CORCMN. 
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Table 4-1: First 512. Bytes of Low Segment for RSX 
+------- fence ee eee pre ee ee ee ee ee ee eee ee ee eee + 
| Byte | Mnemonic | Description 
+------4 fee - eee eee He ee ee ee ee ee ee ee ee ee ee eee ee + 
| 0 | R.TSKN | Task Name in RAD50 
| | | 
| 2 | | 
| | | 
| 4 | R.PRTN | Partition Name in RAD50 
| | | 
| 6 | | ; 
| | | 
| 10 | R.CDSZ | Task Size (without extension, 32-word blocks 
| | | 
| 12 | R.ODTV | ODT SST Vector Address 
| | | 
| 14 | R.ODTL | | ODT SST Vector Length 
| | | 
| 16 | R.SSTV | Task SST Vector Address 
| | | 
| 20 | R.SSTL | | Task SST Vector Length 
| | | 
| 22 | R.FAST | FFP AST Service Address 
| | | 
| 24 | R.CAST | CTRL/C AST Service Address 
| | | 
| 26 | R.TSKF | Task Flags 
| | | 
| 30 | R.PARM | Run Parameter on Entry (from FIRQB+FQNENT) 
| | | 
| 32 | R.CCLF | CCL Entry Flags, Run Size/Extension (XRB+0) 
| | | 
| 34 | R.LDSZ | Load Size of Task in 32-word blocks 
| | | 
| 36 | R.TKSZ | Current Size of Task in 32-word blocks 
| | | 
| 40 | R.LUN | Number of LUNs 
| | | 
| 42 | R.MON] | Monitor RSX Emulation Reserved Word 1 
| | | 
| 44 | R.MON2 | Monitor RSX Emulation Reserved Word 2 
| | | 
| 46 | SDSW | Directive Status Word 
| | | 
| 50 | .FSRPT | FCS Impure Area Pointer 
| | | 
52 | SOTSV | OTS Impure Area Pointer 
| | 
54 | N.OVPT | Auto-Load Impure Area Pointer 
| | 
56 | SVEXT | Extended Impure Area Pointer 
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Table 4-1: 
toc eee terre ere eee 
Byte | Mnemonic 
+------ t--- eee eee 
60 | CONTXT 
| 
: 
112 | FPPTXT 
| | 
| | 
| | 
| 200 | R.LUNS 
| | 
| | 
| | 
| 400 | KEY 
| | 
| 402 | FIRQB 
| | 
| | 
| | 
| 442 | XRB 
| | 
- 
| 460 | CORCMN 
| | 
| | 
| | 
| 660 | PDMSP 
| | 
| 662 | PMDXRB 
| | 
| | 
| | 
| | 
| | 
| 722 | 
| | 
| | 
| | 
| 734 | USRPPN 
| | 
| 736 | USRPRT 
| | 
| 740 | USRLOG 
Po 
| 1000 | NSTORG 
torres terete ee eee 


First 512. Bytes of Low Segment for RSX (Cont. ) 


(Reserved for Monitor Context Use) 


(Reserved for Monitor FPP Context Use) 


LUN Table 


Keyword 


FIRQOB 


XRB 


Core common area 


SP saved here on a PM dump 


XRB saved here on a PM dump 


FIRQB also saved on PM dump starting at PMDXRB 


SP stack space for RSX Emulator 


User’s assignable project, programmer number 


User’s assignable protection code 


User’s logical device table 


Chapter 5: RSX Emulator Directives 


The RSX emulator directives: 
o Perform non-file-structured I/0 
o Let you specify your own exception-handler routines 
o Control execution of the program 
o Return system information to the job 
o Provide access to resident libraries 
Table 5-1 lists these directives by function. The remaining sections 


of this chapter present the directives in alphabetical order. 


Table 5-l: Summary of the RSX Directives 


t------ i i as + 
| Name | Description | 
t-------- Se ee + 
| Non-File-Structured I/0 | 
t-- reer Se + 
ALUNS Assigns a logical unit number to a device and unit. The 


logical unit number then serves to define the device in 
I/O requests. 


Returns information about a logical unit. 


Returns the command line typed by the user to invoke the 
program currently running, if it was invoked by a RSTS/E 
CCL command. 


| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| Open, read from, write to, and close logical units. I/0 | 
| in RSX-emulation mode is synchronous. That is, it is not | 
| asynchronous as in some systems, such as RSX-11M where a | 
| user program can request I/0, do other processing, and | 
| get an interrupt when the I/0 is complete. Thus, under | 
| the RSX emulator, QIOS (queue input/output) and QIOWSs | 
| (queue input/output and wait) do the same thing. Control | 
| returns to the calling program when the I/O is done. | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 


Provides compatibility with RSX-11M, where some 
recoverable error conditions require waiting for some 
significant event to occur before retrying the operation 
that caused the error. In RSTS/E, such events are 
transparent to the user program. WSIGS simply causes the 
program to sleep for one second. 


oe | 
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Table 5-ls: 


Summary of the RSX Directives (Cont. ) 


Provides compatibility with RSX-11M, where RSX uses QIOS 
and WTSES together to cause the program to wait until I/0 
is completed. Since I/O in RSX-emulation mode is 
synchronous, the WTSES is implemented here as a NOP 
instruction. 


SCCAS 


SFPAS 


SVDBS 


SVTKS 


Exits from an FPP exception-handling routine, restoring 
the DSW, PC, and PSW to the values they had before the 
exception occurred. 


Defines an address to which control passes when a user at 
the job’s terminal types a CTRL/C combination. The SCCAS 
directive is unique to RSTS/E; it does not exist in the 
RSX-11M operating system. 


Specifies an address to which control is to pass when an 
FPP exception occurs. (The FPP is available on all PDP-11 
processors that can run RSTS/E, except the PDP-11/35 and 
40.) 


Specifies a table of synchronous exception addresses that 
are to override any specified with an SVTKS directive. 
This is a useful capability for a debugging routine, to 
divert breakpoint traps, for example, to the debugging 
routine regardless of any SVTKS directive in other 
modules of the job. 


Specifies a table of addresses to which control is to 
pass when synchronous exceptions occur. The job can 
handle eight possible exceptions including PDP-11/35 and 
40 FIS errors, TRAP instructions, BPT instructions, IOT 
instructions, and T-bit traps. 


Sets the job’s exit status to "Severe Error" and returns 
control to the job’s keyboard monitor. 


Returns control to the job’s keyboard monitor (a normal 
exit). 
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Table 5-1: Summary of the RSX Directives (Cont.) 


Hoes i i i i a + 

| Name | Description | 

Hone eee ee eee we ee ee ee ee ee eee eee + 

| Program Execution Control (Cont. ) | 

brent eee Herr ee ee ee eee ee eee eee + 
EXSTS Sets the job’s exit status to the specified value and 


returns control to the job’s keyboard monitor. 


| | | 
| | | 
| | | 
| | | 
| EXTKS | Increases or decreases the amount of memory allocated for | 
| | execution of the user job image. | 
| | | 
| | | 
| | | 


addresses for other use, such as expanding the job image 
Or creating another window. 


SPNDS Suspends execution of the program until the user types a 
delimiter on the keyboard (KB:). 
br ee ee eee ee eee + 
| System Access Information | 
teow eee prc ee ee ee ee ee eee + 
| | | 
| GPRTS$ | Returns partition parameters, which contain general | 
| | information about the job area and user job image area. | 
| | | 
| GTIMS | Returns the current day and time. | 
| | | 
| GTSKS | Returns task parameters: run priority, PPN, number of | 
| | logical units assigned, address of SST vector table (set | 
| | up the SVTKS or SVDBS$), and the system in which the job | 
| | is running. | 
teen eee eee eee we ee ee ee ee ee ee ee eee + 
| Resident Libraries Access | 
+-- eee Hr ee ee eee ee ee eee + 
| | | 
| ATRGS | Attaches the job to a resident library, laying the | 
| | groundwork for access to the library. If necessary, the | 
| | resident library is loaded from disk. | 
| | | 
| CRAWS | Creates a window of virtual addresses for reference toa | 
| | library. Optionally, you can map the window to actual | 
| | locations in a resident library. | 
| | | 
| CRRGS | Creates a dynamic region and optionally attaches to it. | 
| | | 
| DTRGS | Detaches the job from a resident library. | 
| | | 
| ELAWS | Eliminates an address window; it releases the virtual | 
| | | 
| | | 
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Table 5-1: Summary of the RSX Directives (Cont. ) 


| 

| Relates a created address window to actual memory 

| locations in an attached resident library. The user 

| program can then refer to locations in the library using 
| the virtual addresses defined in the window. 

| 

RDBBKS | Defines the offsets shown for the RDB areas for the ATRGS 
| and DTRGS directives and, in addition, generates code to 
| allocate space for the RDB and fills it with values you 

| specify in the call. 

| 
RDBDFS | Assigns literal values to the offsets and status bit 

| mnemonics shown for the RDB areas for the ATRGS and DTRGS 
| directives. 

| | 

| Unmaps a window from a library; you can then map the 

| window to another portion of the library or toa 

| different library. 

| 

| 

| 

| 

| 

| 

| 

| 

| 


UMAPS 


WDBBKS Defines the offsets shown for the WDB areas for the 
CRAWS, ELAWS, MAPS, and UMAPS directives and, in 
addition, generates code to allocate space for the WDB 
and fills it with values you specify in the call. 
WDBDFS Assigns literal values to the offsets and status bit 
mnemonics shown for the WDB areas for the CRAWS, ELAWS, 
MAPS, and UMAPS directives. 


ABRTS 


ABRTS$ - Abort 
The ABRTS directive terminates execution of the calling program. Any 
open files or devices are reset (that is, closed without the usual 
clean-up operations). On a RSTS/E system, ABRTS acts the same as the 
EXSTS directive with a severe error. 
Control passes to the job keyboard monitor at the keyboard monitor 
entry point P.NEW (see Chapter 2). The job keyboard monitor is the 
default keyboard monitor unless the job has issued the SET 
JOB/KEYBOARD_MONITOR command or executed the .RTS directive to 
establish a specific job keyboard monitor (see Chapter 3). 
Privileges Required 
None 
Macro Call 

ABRTS name 


RSTS/E ignores the name parameter; the calling program can abort only 
itself. 


Macro Expansion 


ABRTS ALPHA 
- BYTE 83.,3 ;DIC=83., DPB SIZE = 3 WORDS 
-RAD50 /ALPHA/ ; IGNORED IN RSTS/E 


Local Symbol Definitions 

A.BTTN name (4) 

DSW Return Codes 

1E. SDP DIC or DPB size is invalid. This does not occur unless your 
program changes the value of the first word of the DPB during 


execution. Control does not otherwise return inline for the 
ABRTS directive. 


ALUNS 


ALUNS ~- Assign Logical Unit Number 


The ALUNS directive assigns a logical unit number (LUN) to a physical 
device unit. You can then use the logical unit number in QIOS or 
QIOWS directives to do I/O (open, read, write, or close the associated 
device). 


You can specify the device name as any 2-character logical name. The 
RSX emulator checks the name specified in the call against the user 
logical names; if a match is found, the monitor assigns the logical 
unit number to the corresponding physical device. If the device name 
specified does not match any user logical device names, the monitor 
performs a similar search for a match with a system-wide logical 
device name. If there is no match, the emulator checks the monitor’s 
physical device table, and, if a match is found, assigns the logical 
unit number specified in the call to the actual physical device unit 
specified. Otherwise, the directive returns an error. 


Privileges Required 
If the device is restricted, DEVICE is required. 
Macro Call 


ALUNS lun,dev,unt 


where: 
lun is the logical unit number; 1-14. 
dev is the device name; two ASCII characters. 
unt is the device unit number. Minus one indicates no unit 


number, as opposed to a unit number of zero. RSTS/E makes a 
distinction between SY (meaning the public disk structure) 
and SYO (meaning the disk from which the system was booted). 
Likewise, TI, TT, and KB all refer to the job’s terminal, 
whereas KBO and TTO both refer to the system console 
terminal. 


Macro Expansion 


ALUNS 5 TT 40 

- BYTE 7,4 ;ALUNS MACRO DIC=7, DPB SIZE=4 WORDS 
-WORD =) ;LOGICAL UNIT NUMBER 5 

-ASCII /TT/ ;DEVICE NAME IS TT (TERMINAL) 

-WORD 0 ;DEVICE UNIT NUMBER=0 


ALUNS 


; Local Symbol Definitions 

A.LULU Logical unit number (2) 

A.LUNA Physical device name (2) 
A.LUNU Physical device unit number (2) 
DSW Return Codes 

IS.SUC Successful completion. 

IE.IDU Invalid device and/or unit. 
IE.ILU Invalid logical unit number. 


IE.SDP DIC or DPB size is invalid. 


ASTXS 


ASTX$ - Asynchronous Exception Exit 


In the RSTS/E environment, you can use the ASTXS directive to 
terminate a routine that handles an asynchronous FPP exception, only 
if the program has indicated its intention to handle such traps with 
an SFPAS directive. No other condition in RSTS/E causes an 
asynchronous exception from which an ASTXS exit is useful. The CTRL/C 
exception requires only an RTI instruction to exit properly (see 
SCCASS). 


When you execute an ASTXS$, the stack must be in the state: 
SP—»> (DSW) at the time exception occurred 

(PC) at the time exception occurred 

(PS) at the time exception occurred 

word to which SP pointed before the exception 


Note 


The required stack contents is subject to change in 
future releases of RSTS/E. 


Your routine must pop the Floating-Point Exception Code (FEC) and 
Floating-Point Address (FEA) pushed on the stack when the exception 
occurred (see SFPAS). 

When the ASTXS directive executes, the RSX emulator restores the DSW 
value to the DSW location and loads the PC and PS registers with their 
appropriate values. Thus, these values pop from the stack, and 


control returns to the user program at the point where it left off 
when the exception occurred. 


You can change the contents of the PC address in the stack before you 
execute ASTXS so RSTS/E passes control to some point other than where 
it left off. Use caution because it is hard to debug errors in an 
asynchronous exception routine. 
Privileges Required 
None 
Macro Call 

ASTXS [err] 


where: 


err is the error routine address 


ASTXS 


| Macro Expansion 


ASTXSS ERR 

MOV (PC)+,-(SP) ;PUSH DPB ONTO THE STACK 

- BYTE LES .¢24 ;DIC = 115., DPB SIZE = 1 WORD 

EMT 377 ;TRAP TO RSX EMULATOR 

JSR PC,ERR ;JUMP TO ERR IF DIRECTIVE UNSUCCESSFUL 


Note 


DIGITAL recommends the $S form for this directive for 
two reasons: first, only a one-word DPB is generated; 
second, no BCC instruction is generated for the SS 
form (or the $C form). Thus, the $S form takes less 
space than the S$form/DIRS combination. In addition, 
since the one-word DPB requires only one MOV 
instruction, the $S form takes less space and no more 
execution time than the $C form. 


Local Symbol Definitions 
None 


DSW Return Codes 


IE.SDP DIC or DPB size invalid. This occurs only if your program 
changes the first word of the DPB at execution time. 


ATRGS$ 


ATRGS - Attach Resident Library 


The ATRGS directive attaches the job to a resident library. The type 
of access (read-only or read/write) is specified in the call. If the 
calling job can access the library in that fashion, the monitor sets 
up its own internal tables that lay the groundwork for the job to map 
windows to the library. Note, however, that the resident library does 
not take up space in the job area (virtual memory) with an attach. 
Virtual memory is assigned when a window is created (CRAWS). 


Note 


The job’s ability to access the resident library 
depends upon the protection assigned by the system 
manager when the resident library was installed. The 
default protection grants read access to all users 
and denies write access to all users. 


If the attach is successful, a resident library ID is returned to the 
job. Other directives use this ID to detach the job from the library 
(DTRGS$) or to map and unmap windows to and from the library (MAPS and 
UMAPS). Once the monitor attaches the job to a library, you can use 
the ATRGS directive to determine the library ID. 


You can attach an unlimited number of resident libraries to a job at 
any given time, provided the system has enough resources to keep track 
of the list of attached libraries. 

Privileges Required 


None 


Macro Call 


ATRGS adr 
where: 
adr specifies the address of an 8-word area defining the library 


to be attached and the type of access desired. The ATRGS 
directive returns information to this area. Two 
supplementary directives are available to define (RDBDFS) or 
define and fill (RDBBKS) such an 8-word area, called the 
resident library definition block (RDB). 


Macro Expansion 


ATRGS RDBLK 
. BYTE 57.52 sDIC = 57., DPB SIZE = 2 WORDS 
. WORD RDBLK s;ADDRESS OF RDB 
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ATRGS$ 


Data Passed in RDB 


Mne- Octal 
monic Offset 


a 


3 


17 


adr+R.GNAM 


adr+R.GSTS 


Octal Mne- 
Offset monic 


WELLE 

WZ 2 

a: resident library name. —~—~—~—S=«|s 4s GNAN 
(2 words in RAD50 format) | 

Lee aoueeen eee ee eer a 


CELE ab EES MAAS N ED LA MAME E MEARE AALS 10 


oe Se ee ar + 
LILLILLILT LILA ILLLLELTIL ALT LL ADDED ADD LLE 12 
wt ee ee ee eee eee 0 re © 

access flags | 14 R.GSTS 
eet ee ee ee ee ee ee eee 2 


CEC EE LEER MI KEA EA LES SAA AA AEM GERMAN 16 


is the name of the resident library to which the job is 
to be attached, as two words of RAD50 data. (The system 
Manager makes resident libraries known to the RSTS/E 
monitor with the INSTALL/LIBRARY command (see the RSTS/E 
System Manager’s Guide). With this command, the system 
manager defines a file (filename.LIB) as a resident 
library. The monitor regards "filename" as the resident 
library’s name.) 


is the low-order two bits in this word which defines the 
clesired access to the library. 


RDBBKS, 

RDBDFS 

Mnemonic Bit Meaning 

RS.RED 0=l1 Read-only access is desired 
RS .WRT l=] Read/write access is desired 


Once RSTS/E attaches a job to a resident library, the 
access cannot be changed without detaching (DTRG$) and 
reattaching. Also, an ATRGS with the same resident 
library name specified at adr+R.GNAM returns the 
assigned resident library ID. 


ATRGS 


Data Returned to RDB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
tee ee eee ee ee eee eee eee t---- ee ee ee ee ee eee eee + 
1 | resident library ID | QO R.GID 

tener eee ee eee eee ee eee terre eee ee ee ee eee ee eee + 
S 4 size of library, in 32-word blocks | 2 R.GSIZ 
teen ee re eee eee ee eee +---- eee ee ee ee ee eee eee + 
“AAA AAA 
t-- 2 ee ee ee ee ee ee ee eee Sn + 
DP NGSAILILIAII ISAS PLATA AAAAAIATT ATI AAS SILA OTST | 8 
Se terre ee ee ee ee ee ee eee + 
11 AS REI E AA HOt AeA 10 
Se + 
13 A LLLLILLALSTLPLALSLIPL IPL A LAAT ALP ATPL ATID | 12 
tener ee ee eee ee eee t--- eee eee ee ee eee eee + 
15 NOELLE CEO ACO 14 
Si: + 
17 A PLLLLPLLILLILLATPPAPPATPLLPPALPDAL SAT PPTTS 16 
tee eee ee ee ee ee eee eee t--- eee ee eee ee ee eee eee + 
adr+R.GID is an identifier which must be used in subsequent calls 


to identify a resident library, rather than the resident 
library name. Thus, you use this identifier to detach 
(DTRGS) and to map and unmap windows (MAPS and UMAPS) to 
the library. 


adr+R.GSIzZ is the size of the resident library, in 32-word blocks. 
Local Symbol Definition 

A.TRBA Resident library definition block address (2) 

DSW Return Codes 

IS.SUC Successful completion. 


IE.UPN Attaching a job to a resident library requires a small buffer; 
no small buffers are currently available. 


IE.PRI The attach did not succeed because the caller’s privileges do 
not allow the access requested. This could happen either 
because the access code specified is not compatible with the 
possible access defined when the library was installed by the 
system manager or because the protection code associated with 
the resident library file excludes the access requested by the 
user. 


IE.PNS The resident library name specified is not known to the 
monitor. The system manager must install a resident library 
before the system can use it. 
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CRAWS 


'CRAWS - Create Address Window 


You can use the CRAWS directive either to create a window (a range of 
virtual addresses) or to create a window and map it to a range of 
actual addresses in an attached resident library. You define the 
range of addresses by naming a base APR, which defines the starting 
virtual address for the window, and by specifying the size of the 
window in 32-word blocks. Thus a window always begins on a 4K-word 
boundary in virtual memory. It may take more than 4K words, depending 
on the size of the window. 


If the virtual address range overlaps the user job image, the call 
fails with an error. If the address range overlaps an existing 
window, the system eliminates the previously created window. 


The difference between creating a window and creating and mapping a 
window is best illustrated by example. By using create without map, 
you can define one window, which can be mapped to a library or portion 
of a library and then remapped using MAPS to another portion of the 
same library or another library, as many times as desired. For 
example, suppose your program takes up 24K words, and you want to 
access a 24K-word resident library of data values. You can use create 
without map to set up a 4K-word window in APR 6. You can then map the 
window to the first 4K words of the library, process the data, map to 
the next 4K words of the library, and so forth. 


If, on the other hand, you had a 4K-word program and still wanted to 
access a 24K-word library, you could use CRAWS to create a 24K-word 
window and map it to the entire library in APRs 1-6. 


A job can create a maximum of seven windows. A window takes at least 
one APR, possibly more, depending on the size you specify for the 
window. Thus, the maximum of seven assumes seven 4K windows in APRs 1 
through 7. You can never use APR 0 to create a window, since the user 
program takes at least this much space. As mentioned previously, a 
window cannot overlap the user job image; thus, the size of the user 
job image determines the lowest base APR that the job can use. If the 
program (user job image) is less than 4K words, you can use APRs 1 and 
up (to the limit imposed by the run-time system boundary) to create 
windows. If the user job image is between 4K words and 8K words, you 
can use APRs 2 and up to create windows, and so forth. 


If you create a window that overlaps an already existing window, 
RSTS/E eliminates the old window. For example, if you create a 
6K-word window using a base APR of 5, the window uses APRs 5 and 6. 

If you then create a 4K-word window using a base APR of 6, RSTS/E 
eliminates the entire old window. APR 5 is free for other use; RSTS/E 
uses APR 6 for the new window. 


Privileges Required 


None 


CRAWS 


Macro Call 


CRAWS adr 
where: 
adr is the address of an 8-word area defining the window and the 


resident library to which the window is to be mapped, if 
mapping is requested. The CRAWS directive also returns 
information to this area. Two supplementary directives are 
available to define (WDBDFS) or define and fill (WDBBKS) 
such an area, called the window definition block (WDB). 


Macro Expansion 


CRAWS WDB 
- BYTE Lil .¢2 ;DIC = 117., DPB SIZE = 2 WORDS 
-WORD WDB ;ADDRESS OF WDB 


Data Passed in WDB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herter eee ee eee ee ee eee trent eee eee eee ee eee + 
1 | base APR (1-7) \ASASSA11111/1111/1//7/\ % WsNAPR 

Herre eee ee ee eee eee Herre ee ee ee ee ee ee ee eee + 
ZB YSSAIIIIIIIISAALAAIAA AAA AIA AAA AAA AAA AAAS | 
terre ee ee ee ee eee eee eee terre eee eee ee eee eee + 
5. || size, in 32-word blocks, of window | 4 W.NSIZ 
Herre ee eee ee eee eee tern ne ee ee eee ee eee eee + 
7 | resident library ID (for map) | 6 W.NRID 
Herre ere ee ee eee eee eee tenn eee ee eee eee eee eee + 
11 | offset, in 32-word blocks (for map) | 10 W.NOFF 
Hen rer eee ee eee eee eee Herre eee eee eee eee + 
13 | map length, in 32-word blocks | 12 W.NLEN 
terre ee eee ee ee ee eee teen ee ee ee ee ee ee ee eee + 
15 | access flags | 14 W.NSTS 
Horr ee eee eee ee tere ee eee ee eee ee eee + 
LT SASSI AISAIAAAAAA AAA AAA AAA AAA AAA AAA AAAS 7 \ 16 
Herre eee eee ee eee Hen rere ee ee ee ee eee + 
adr+W.NAPR is the base APR of the window, 1-7 that implicitly 


defines the starting address of the window. This byte 
cannot be zero, nor can it name an APR already being 
used to map the user job image (see previous 
discussion). 


adr+w.NSIZ Is the desired size of the window, in 32-word blocks. 
For example, a value of 128 = 4K words. 


adr+W.NRID is the identifier of the resident library to which the 
window is to be mapped. (This is the value returned at 
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adr+wW.NOFF 


adr+W.NLEN 


adr+w.NSTS 


CRAWS 


adr+R.GID in the RDB for an ATRGS directive.) This word 
is ignored for calls requesting a create without mapping 
(bit 7 at adr+W.NSTS is zero). 


is the offset, in 32-word blocks, from the start of the 
library where the mapping is to begin. This word is 
ignored if no mapping is requested (bit 7 at adr+W.NSTS 
is zero.) A value of zero for this word indicates the 
window is to be mapped beginning at the first byte of 
the library. A value of one indicates the window is to 
be mapped beginning at the 33rd word of the library 
(starting address + 64), and so forth. 


is the length, in 32-word blocks, of the area to be 
mapped (ignored if bit 7 at adr+W.NSTS is zero). This 
value cannot be greater than the length of the window 
specified at adr+wW.NSIZ. In addition, this value, 
combined with the offset specified at adr+W.NOFF, cannot 
indicate an address beyond the end of the library. 


A value of zero defaults to either the size of the 
window or the space remaining in the library, whichever 
is smaller. 


is the access-flags word. Two bits of this word define 
whether the window is to be mapped and whether read-only 
access or read/write access to the window is desired. 


WDBDFS, 
WDBBK$ 
Mnemonic Bit Meaning 
WS .MAP om The window is to be mapped 
= 0 The window is not to be mapped 
WS .WRT 1 = 1] Read/write access is desired 
= 0 Read-only access is desired 


CRAWS 


Data Returned in WDB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
tere eee ee ee eee eee eee perenne ee ee ee ee eee eee + 
LYSSAAASI AAAS S AAAS SC | window ID | 0 W.NID 
terre ee ee te ee eee eee eee tere ert ee ee eee ee eee + 
3 starting virtual address of window i) <2 W.NBAS 
tee eee ee ee ee eee ee eee terre ree eee ee eee ee eee + 
5 MOG Ge | 4 
i oe + 
7 A LPLIPILLLLPLTLLIPITPPAL PLAS TAPAAPTDI SADIE 6 
tence eee eee eee eee eee tener eee ee eee ee eee eee + 
11 LLLLLLLLLLLLLLLL LLL LILA LLLLLLL LLL LLL LLLLLL \ 10 
tere re re ee ee eee eee tere ee eee ee eee ee eee eee + 
LS || length, in 32-word blocks, mapped | 12 W.NLEN 
tere eer ee ee ee ee ee eee tee cee eee ee eee eee eee + 
15 | status flags | 14 W.NSTS 
terre eee ee ee eee ee ee eee teeter eee ee ee eee eee + 
LT SSAA AIIIIIAAS AAAI SAAS ASA AAAS AAA AAAS \ 36 
terre eee ee ee eee ee ee eee per ree eee ee eee eee ee eee + 
adr+w.NID is the window ID, a value from 1-7. You can use this ID 


in later MAPS calls to map the newly created window. 


You must use the ID in any ELAWS calls to eliminate the 


window. 
adr+W.NBAS is the starting virtual address of the new window. 
adr+W.NLEN is the length, in 32-word blocks, actually mapped by the 
window. 
adr+W.NSTS is the status-flags word. 
WDBDFS, 
WDBBK$ 
Mnemonic Bit Meaning 
WS .CRW 15 = 1 The window was created successfully 
= 0 The window was not created 
WS .ELW 13 = 1 An existing window was eliminated 
because it overlapped the newly 
created window 
= 0 No existing windows were eliminated 
by this create 
WS .UNM 14 =1 An existing window was unmapped 


because it overlapped the newly 
created mapping 

= 0 No existing windows were unmapped 
by this mapping 
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CRAWS 


_Local Symbol Definitions 


C.RABA 


Window definition block address (2) 


DSW Return Codes 


IS.SUC 


IE.ALG 


IE.NVR 


IE.PRI 


IE .WOV 


IE.UPN 


Successful completion. 


Either the base APR and window length specified were invalid 
or the offset and mapping length values specified were 
invalid. For example, an offset indicating a starting address 
for the mapping that was beyond the end of the library returns 
this error. 


The library ID specified for mapping does not specify any 
library currently attached to the job. 


The create was unsuccessful because the requested access is 
not allowed. At this point, since the library has been 
attached successfully with some access defined, this error 
means that the access requested in the CRAWS is not allowed by 
the access requested in the ATRGS. 


An attempt was made to create more than seven address windows. 


Creating a window requires a small buffer; a small buffer is 
not currently available. 


CRRGS 


CRRGS -- Create Dynamic Region 


The CRRGS directive creates dynamic regions similar to those created 
by UU.RTS. This call operates in a slightly different manner than its 
counterpart. If an attempt is made to create a region that already 
exists, CRRGS returns with bit 15 in R.GSTS clear. If attachment is 
specified and the region already exists, the new region is attached to 
the already existing region. 


Privileges Required 
INSTAL 


Macro Call 


CRRGS adr 
where: 
adr is the address of an 8-word Region Descriptor Block (RDB). 


The CRRGS directive also returns information to this area. 


Macro Expansion 


CRRGS$ RDBLK 
- BYTE cee eare ;DIC = 55., DPB SIZE = 2 WORDS 
-WORD RDBLK ;ADDRESS OF RDB 


Data Passed in RDB 


Mne- Octal Octal rine- 
monic Offset Offset monic 
toe -ree e e e  e e eee eeeeee tener e ee ee ee eee ee eee + 
1 UZ dddaaaaiiiiida 0 
: i as + 
3 | size in 32-word ee of region Eb create| 2 R.GSIZ 

Sr tenner er ee ee eee eee + 
Sl name of region, or 0 for unnamed | 4 R.GNAM 
+ (2 words) + 
7 | | 6 
tere ee ee eee eee eee eee t--- eee ee ee ee ee ee eee + 
11 ASG ALA CELA EAL AMA KAU SAGE Eh AREAL GLE 10 
+ e-em we we ewe wee wwe ewes wse ee we we eo er weer e eee wee ew eee ws ew ew ew + 
13  LLPILLIPLILLALATLADLL PLA PTIPADP APPT PTAD TDS 12 
Sl Si + 
15 | region status | 14 R.GSTS 
St 5 + 
17 | region protection in RSX format | 16 R.GPRO 
Se 5 el + 


CRRGS 


adr+R.GSTS are the status bits that are currently defined as 
follows: 
Bit 5 -- Attach me to region (forced if unnamed region) 
Bit 7 -- Delete region when all users detach (forced if 


unnamed region) 


adr+R.GPRO is the region protection code converted from RSX format 
to RSTS/E format by the following algorithm: 


o The system field is ignored 

o Delete protection is ignored 

Oo Extend protection is ignored 

o Read protection is mapped to RSTS/E read protection 


o Write protection is mapped to RSTS/E write 
protection 


Data Returned in RDB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
Sa Se + 
1 | region ID of created region | O R.GID 

terre eee eee ee eee eee terre eee ee eee eee eee eee + 
3 | size of the region in 32-word blocks | 2 R.GSIZ 
Hence eee re ee er eee eee tener ree ee eee eee eee + 
5 Vda 4 
Se + 
7  PLSLILLIPLILPALLILTILALLAPTIDAPDADLADALAD 6 
Heer te eee ee ee ee eee Se + 
LL SASSI IAAI IAI AIIAI AAAS AAA AA AAA AAA AAA 1\ 0 
pence ee ee ee ee eee eee Sl + 
13 eS EARL ta AANA MEAL IAA CAEL MARE 12 
Se + 
Is : status “flags | 14 R.GSTS 
-_—se ee eee eneen eee eww we ww eee ewe ew ewww ew wee www wwe ew + 
17 WLLL 16 
ie + 
adr+R.GSTS is the status-flags word. Bit 15 is clear if the region 


already exists. 


CRRGS$ 


DSW Return Codes 
IS.SUC Successful completion. 
IE.PRI User does not have INSTAL privilege. 


IE.UPN Creation failed, examine FIRQB for details. 


DTRGS 


DTRGS - Detach Resident Library 


The DTRGS directive detaches the job from a previously attached 
resident library. Any windows mapped to the library by the calling 
job are unmapped and eliminated. If the specified library is a 
dynamic region marked for deletion when all users detach, the monitor 
checks if the region is no longer attached by any job. If so, the 
monitor deletes the region and releases the memory allocated to it. 


Privileges Required 
None 


Macro Call 


DTRGS adr 
where: 
adr is the address of an 8-word area defining the library to be 


detached. The DTRGS directive also returns information to 
this area. Two supplementary directives are available to 
define (RDBDFS) or define and fill (RDBBKS$) such an 8-word 
area, called the Resident-Library Definition Block (RDB). 


Macro Expansion 


DTRGS RDBLK 
- BYTE oS peer ;DIC = 59., DPB SIZE = 2 WORDS 
. WORD RDBLK ;ADDRESS OF RDB 


Data Passed in RDB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
[i i a + 
1 | resident library ID | 0 R.GID 

pence ee ee eee eee eee eee i i reer. + 
3 OE ee IE 2 
tee ee ee epee me ee ee eee + 


DTRGS 


adr+R.GID is the library ID the ATRGS directive returns (at the 
same position in the RDB). 


Data Returned in RDB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 


in AAA AAA hhh 
3 EEA SEE GEE MIE MU Mab MAREE | ME DAES, 2 


15 | eae. flags | 14 R.GSTS 


adr+R.GSTS is the status flag, bit 14, that defines if any windows 
were unmapped as a result of this detach. 


Local Symbol Definitions 

D.TRBA Resident-Library Definition Block address (2) 
DSW Return Codes 

IS.SUC Successful completion. 


IE.NVR The library ID specified does not identify any library 
currently attached to the job. 


ELAWS 


, ELAWS -- Eliminate Address Window 

The ELAWS directive eliminates an address window that was created by 
the job, unmapping the window if necessary. ELAWS frees the APRs used 
by the window and makes them available for creating another window or 
for expanding the user job image size. 

Privileges Required 


None 


Macro Call 


ELAWS adr 
where: 
adr is the address of an 8-word area defining the window to be 


eliminated. The ELAWS directive also returns information to 
this. Two supplementary directives are available to define 
(WDBDFS) or define and fill (WDBBKS) such an area, called 
the Window Definition Block (WDB). 


Macro Expansion 


ELAWS WDBADR 
» BYTE a ip ere ;DIC=119., DPB SIZE=2 WORDS 
»WORD WDBADR ;ADDRESS OF WDB 


Data Passed in WDB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 


LSSAIIIAIISSAA1ASAA10C | window ID | O W.NID 
3 Adddhbddbbddbdddddddbdddddddddddddddddddda 2 


15 MMMM 14 
17 VILL 16 


ELAWS 


adr+W.NID is the ID of the window to be eliminated (returned at 
the same location in the WDB by the CRAWS directive). 


Data Returned in WDB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
Se 5 il + 
1 TACK SEER KAALRE A MAMA A SAAC 0 
i ee + 
3 Zed 2 
i es + 
) LPILLILLALL ALLEL APLPL IPL APTTPAITEDTD LD 4 
5 il i + 
Ui VALLE hh 
i 5 + 
LL WSASSAASSISSIIA ASAI IS IAAI ASA AAAS AAA A1 14077 \ V0 
| 5 i + 
13 LTE LE ECE 12 
i es + 
ES: | seeae flags | 14 W.NSTS 

tern rr ee ee eee eee Si + 
LD SSSA AASSIIAI AAAS AAAS AAA AAA AAA AAS AA 7 \ 16 
i Se + 
adr+wW.NSTS is the status-flags word. Two bits in this word give 
the following information: 
WDBDFS, 
WDBBKS$ 
Mnemonic Bit Meaning 
WS.ELW 13 = 1 The window was successfully 
eliminated 
= 0 The window was not eliminated 
WS .UNM 14 =1 The window eliminated was mapped to 
a resident library and has been 
unmapped 


= 0 The window eliminated was not 
mapped; no unmapping was done 


Local Symbol Definitions 

E.LABA Window Definition Block address (2) 
DSW Return Codes 

IS.SUC Successful completion. 


IE.NVW Bad window ID. It is either outside the range 1 to 7 or it 
does not match any window currently created for this job. 
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EXITS 


EXITS - Task Exit 
The EXITS directive stops execution of the calling job. Control 
passes to the job keyboard monitor at the keyboard monitor entry point 
P.NEW (see Chapter 2). Any devices still open are reset; that is, 
closed without performing the usual clean-up operations. 
Note 

On exiting from the previously running program, the 

monitor drops any temporary privileges still in 

effect. 
The job keyboard monitor is the default keyboard monitor unless the 
job has issued the SET JOB/KEYBOARD_MONITOR command or executed the 
-RTS directive to establish a specific job keyboard monitor (see 
Chapter 3). 
Privileges Required 
None 
Macro Call 

EXITSS [err] 

where: 


err is the error routine address. 


Macro Expansion 


EXITSS ERR 

MOV (PC)+,-(SP) 7;PUSH DPB ONTO THE STACK 
-BYTE op ears | ;DIC = 51., DPB SIZE = 1 WORD 
EMT 377 ;TRAP TO THE EMULATOR 

JSR PC,ERR ;CALL ERROR ROUTINE 


EXITS 


Note 


DIGITAL recommends the $S form for this directive for 
two reasons: first, only a one-word DPB is 
generated; second, no BCC instruction is generated 
for the $S form (or the $C form), since control never 
returns inline unless an error occurs. 


Thus, the $S form takes less space than the §$ 
form/DIRS combination. In addition, because the 
one-word DPB requires only one MOV instruction, the 
$S form takes less space and no more execution time 
than the $C form. 

Local Symbol Definitions 

None 


DSW Return Codes 


IE.SDP DIC or DPB size is invalid. This occurs only if your program 
changes the first word of the DPB at execution time. 


EXSTS 


, EXST$ - Exit with Status 


Like EXITS, the EXSTS directive stops execution of the calling job. 
On exiting from the previously running program, the monitor drops any 
temporary privileges still in effect. In addition, EXSTS sets the 
job’s exit status. 


Control passes to the job keyboard monitor at the keyboard monitor 
entry point P.NEW (see Chapter 2). Any devices still open are reset; 
that is, closed without performing the usual clean-up operations. The 
monitor detaches any attached resident libraries, and eliminates any 
created address windows. 


Note 
The job keyboard monitor is the default keyboard 
monitor unless the job has issued the SET 
JOB/KEYBOARD_MONITOR command or executed the .RTS 
directive to establish a specific job keyboard 
monitor (see Chapter 3). 
Privileges Required 


None 


Macro Call 


EXSTS sts 
where: 
sts is the status value. DCL copies this data into the 


SSEVERITY and SSTATUS variables (see the RSTS/E Guide To 
Writing Command Procedures). 


Macro Expansion 


EXSTS STATS 
- BYTE 29.,2 ;DIC=29., DPB SIZE = 2 WORDS 
- WORD STATS ;EXIT STATUS WORD 


EXSTS$ 


Local Symbol Definitions 


E.XSTS 
EXSWAR 
EXS$SUC 
EXSERR 


EXSSEV 


Exit status word (2) 
Warning status code 
Success status code 
Error status code 


Severe error status code 


DSW Return Codes 


No errors are possible with EXSTS. 


EXTKS 


y EXTKS - Extend Task 


The EXTKS directive lets you increase the amount of memory allocated 
to the user job image. For compatibility with RSX-11M, the argument 
specified in the call indicates a positive or negative increment of 
32-word blocks. However, the RSTS/E monitor actually allocates space 
for the user job image in 1K-word units. Thus, the RSX emulator keeps 
track of the user job image size as a number of 32-word blocks. When 
an EXTKS directive is executed, the emulator checks to see if the 
extension or reduction needs or frees one or more 1K-word blocks of 
memory. If so, the emulator directs the monitor to make the new 
allocation; if not, the current allocation remains. 


Note 


Do not use the .CORE directive (see Chapter 3) before 
an EXTKS directive in the same program. The monitor 
executes the .CORE directive directly, without the 
intervention (or knowledge) of the RSX emulator. If 
a .CORE executes before an EXTKS, the emulator has 
incorrect information on the current size of the user 
job image when it executed the EXTKS, and it bases 
the new allocation on the size before the .CORE was 
executed. 


You cannot extend the size beyond the least of the following: 


o The job’s private maximum size -- A private job maximum size 
can be set by the system manager. 


o The system-wide maximum user job image size -- Set by the 
system manager (see SWAP MAX, RSTS/E System Installation and 
Update Guide). 


o 32K-32 words -- The maximum size allowed by the RSX emulator. 


You also cannot extend the size of the image into virtual address 
space used by an address window created for use with resident 
libraries (see CRAWS directive). 


Note 


If I&D space is in use, the size applies only to the 
D-space of the task. The size of the I-space is 
fixed at task load time. 


If there is not enough contiguous memory for the extension to be made 
where the job currently is in memory, the monitor swaps the user job 
image to disk and then returns it to memory at a location that can 
accomodate the new size. 


EXTKS 


If no increment is given in the call, the emulator allocates the 
amount of space the job had initially, based on information built in 
at link time (with TKB); that is, before any EXTKS was executed. 
Privileges Required 
None 
Macro Call 

EXTKS [inc] 
where: 

inc is the number of 32-word blocks by which the task size is to 

be extended (positive value for inc) or reduced (negative 


value for inc). 


Macro Expansion 


EXTKS 40 

- BYTE 89.,3 s;DIC = 89., DPB SIZE = 3 WORDS 
. WORD 40 ;EXTEND 40(8) BLOCKS (1K WORDS) 
.WORD 0 ;RESERVED WORD 


Local Symbol Definitions 

E.XTIN Extend increment (2) 

DSW Return Codes 

IE.SUC Successful completion. 

IE.UPN The requested increment would have caused the user job image 


size to exceed that allowed (see previous discussion). The 
user job image size stays at the current size. 


GLUNS 


GLUNS ~ Get LUN Information 


The GLUNS directive fills a 6-word buffer with information about a 
physical device unit to which a logical unit (LUN) is assigned. 


Privileges Required 
None 
Macro Call 


GLUNS lun,buf 


where: 
lun is the logical unit number. 
buf is the address of the 6-word buffer to receive the 


information. 


Buffer Format 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
Sr tere rer ee ee ee ee eee eee + 
1 | dieviice name (2 ASCII characters) | OQ G.LUNA 

tener ee ee ee ee ee eee eee teen ee eee ee ee eee eee eee + 
3 | device unit number | 2 G.LUNU 
iis i + 
5.2] first device characteristics word | 4 G.LUCW 
tee ee ee ee ee ee ee eee eee +--+ ---- eee ee eee eee + 
| second device ionamin ad word | 6 
Se a + 
li Vad 10 
Se as + 
13 | standard sevice buffer size | 12 
tee ee er ee ee ee eee eee Se + 


buf +0 is the name of the assigned device; two ASCII characters. 
This must be a valid physical device name. Exceptions are the 
logical device names OV and LB, which default to SY if they 
are not defined, and CL, which defaults to TT. 


buf+2 is the unit number of the assigned device. If this word is 
minus one, it indicates there is no unit number. If this word 
is zero or a positive number, it is a real unit number. 


GLUNS 


buf+4 is the first device characteristics. The bit settings are: 
Bit Meaning When Set 


0 Record-oriented device 
1 Carriage-control device 
2 Terminal device 

3 Directory device 

4 Single-directory device 
5 Sequential device 

15 Reserved 


Settings for bits 0-5 are (in octal): 


01 = Card reader 

01 = Paper tape reader/punch 
02 = Line printer 

03 = Terminal 

10 = Disk 

40 = Magtape 


buf+6 is the privilege status. If this word is zero, it indicates 
the job is nonprivileged. If this word is eight, it indicates 
the job is privileged. 


buf+12 is the standard device buffer size to use for input or output 
on this device. 


Macro Expansion 


GLUNS 7, LUNBUF 

. BYTE 5,3 *DIC = 5, DPB SIZE = 3 WORDS 
. WORD 7 :LOGICAL UNIT NUMBER 7 

.WORD LUNBUF s;ADDRESS of 6-WORD BUFFER 


Local Symbol Definitions 
G. LULU Logical unit number (2) 
G.LUBA Buffer address (2) 


The monitor assigns the following offsets relative to the start of the 
LUN information buffer: 


G.LUNA Device name (2) 

G.LUNU Device unit number (1) 

G.LUFB Flags byte (not used in RSTS/E) (1) 
G.LUCW Four device characteristics. words (8) 
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DSW Return Codes 


IS.SUC Successful completion. 

IE.ULN Unassigned LUN. 

IE.ILU Invalid logical unit number.(must be in range 1-14). 
IE.SDP DIC or DPB size is invalid. 


GMCRS 


GMCR$ - Get MCR (CCL) Command Line 

The GMCRS$ directive transfers an 80-byte CCL command line to the job. 
The program that processes an installed CCL command must contain code 
to analyze what you typed to invoke the file. The GMCRS directive 
returns the command line you typed in an 80-byte buffer in the DPB. 


This directive has no $S form. Because the DPB receives the CCL 
command line, the space must be allocated in read/write memory. 


Privileges Required 
None 
Macro Call 

GMCRS$ 


Macro Expansion 


GMCRS 
.BYTE 127.,41. ;DIC = 127., DPB SIZE = 41. WORDS 
. BLKW 40. ;80-CHARACTER CCL COMMAND BUFFER 


Local Symbol Definitions 
G.MCRB CCL command buffer (80) 
DSW Return Codes 


+n Successful completion. The value n is the number of data 
bytes transferred (excluding the termination character). 


IE.AST Task was not run as a CCL command or the GMCRS directive has 
already been executed. 


IE.SDP DIC or DPB size is invalid. 


GPRTS 


GPRTS - Get Partition (Job) Parameters 


The GPRTS directive fills a 3-word buffer with partition parameters. 
For RSTS/E, a partition corresponds to the job area. 


Privileges Required 
None 
Macro Call 

GPRTS [name] ,buf 
where: 


name is the partition name. Omit this parameter to get the 
actual job image size in buf+2. 


buf is the address of the 3-word buffer where information is to 
be returned. 


Buffer Format 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
ter nee ee eee eee eee tere eee ee ee ee eee eee eee + 
1 | wireial: base address (always 0 in RSTS/E) | 0O G.PRPB 
+--+ eee wee eee eee eee tenn renee ee ee ee ee eee + 
3 | user yO image size in 32-word blocks | 2 G.PRPS 
Se tener eee ee ee eee ee eee + 
5. flags word (always 0 in RSTS/E) | 4 G.PREW 
tence eee eee ee eee eee teen ee eee eee eee ee eee + 
name is the partition name. Omit name to get the actual job image 


size in buf+2. 


buf+2 is the partition size (user job image size in RSTS/E), 
expressed as a multiple of 32 words. If I&D space is enabled, 
this reflects only the size of the D-space of the task. If 
you give a partition name, the system SWAP MAX is returned, in 
32-word units. 


buf+4 is the partition flags word. Always returned as zero, since 
all jobs are system-controlled in RSTS/E. (RSX-11M returns 
one for a user-controlled partition. ) 


Macro Expansion 


GPRTS , DATBUF 

- BYTE 65%74 ;DIC=65., DPB SIZE = 4 

-WORD 0,0 ;GENERATE 0 WORDS IF NO NAME 
-WORD DATBUF ;ADDRESS OF 3-WORD BUFFER 
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Local Symbol Definitions 
G.PRPN Partition name (4) 
G.PRBA Buffer address (2) 


The monitor assigns the following offsets relative to the start of the 
buffer: 


G.PRPB Partition virtual base address (2) 
G.PRPS Partition size (2) 
G.PRFW Partition flags word (2) 


DSW Return Codes 


Successful completion is indicated by carry clear, and the starting 
address of the partition is returned in the DSW (always zero in 
RSTS/E). Unsuccessful completion is indicated by carry set and the 
following code in the DSW: 


ID.SDP DIC or DPB size is invalid. 


GTIMS 


' GTIMS ~ Get Time Parameters 


The GTIMS directive fills an 8-word buffer with the current day and 


time of day. 


All time values are stored as one-word binary integers. 


The value ranges (in decimal) are shown in the following diagram. 


Privileges Required 


None 


Macro Call 


GTIMS buf 
where: 
buf is the address of an 8-word buffer. 


Buffer Format 


Mne- Octal 
monic Offset 


1 | 
3 | 


5 | 


17 | 


G.TIBA+G.TICT 


Octal Mne- 
Offset monic 


wr ee eee ee eee Horr ee ee ee ee ee et 
year ‘(eines 1900); such as 78 =1978 | O G.TIYR 

weer eee ee eee eee Se | 
a OAER (1-12); such as 1 = January | 2 G.TIMO 

wer ee eee ee eee oe | 
day of month (1-31) | 4 G.TIDA 

weer ee eee eee eee Horr ee ee ee ee ee ee et 
re (0-23); such as 0 = midnight | 6 G.TIHR 

wert eee eee eee eee oe | 
minute (0-59) | 10 G.TIMI 

wer ee ee ee eee Sr | 
second (0-59) | 12 G.TISC 

we re ee ee eee Se | 
tick of second | 14 G.TICT 

we ee ee ee eee | 
ticks per second | 16 G.TICP 

wee ee eee ee eee tre eee ee ee ee ee ee et 


Indicates a tick which is either 1/60th or 1/50th of a 
second, depending on the clock in use and/or the line 
frequency. Systems running with the KW11P clock at 
crystal speeds, rather than at line frequency, have a 
tick of 1/50th of a second. Otherwise, if the system 
is operating with a 60 Hz power line, a tick is 1/60th 
of a second. 


GTIMS 


Macro Expansion 


GTIMS DATBUF 
- BYTE 61.,2 ;DIC = 61., DPB SIZE = 2 WORDS 
- WORD DATBUF ;ADDRESS OF 8-WORD BUFFER 


Local Symbol Definitions 
G.TIBA Buffer address (2) 


The monitor assigns the following offsets relative to the start of the 
buffer: 


G.TIYR Year (2) 

G.TIMO Month (2) 

G.TIDA Day (2) 

G.TIHR Hour (2) 

G.TIMI Minute (2) 

G.TISC Second (2) 

G.TICT Clock tick of second (2) 
G.TICP Clock ticks per second (2) 


DSW Return Codes 
IS.SUC Successful completion. 


IE.SDP DIC or DPB size is invalid. 


GTSKS 


GTSKS - Get Task (Job) Parameters 

The GTSKS directive fills a 16-word buffer with parameters for the 
task. As with partition in GPRTS, a task in the RSTS/E environment is 
equivalent to the job. 

Privileges Required 


None 


Macro Call 


GTSKS buf 
where: 
buf is the address of the 16-word buffer to receive the 
parameters. 


GTSKS 


Buffer Format 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
Herre eee ee ee eee eee Herre eee eee ee eee eee + 
1 | task name | O G.TSTN 
| (2 words in RAD50 format) | 
3: || | 2 
er tee ee ee ee ee ee eee eee + 
5 | partition name | 4 G.TSPN 
| (2 words in RAD50 format) 
- | | 6 
Se terre ere ee eee ee eee + 
LL |SSSSAAAIAIIIIA IAAI AAAI AAAS AAA AAS AAAS A477 \ 10 
5 i Se + 
13 Ee el LE Ee CL 12 
Se a ie + 
15 | run Briere (0-255) | 14 G.TSPR 
Sl Sr + 
G.TSPC 17 | project number | programmer number | 16 G.TSGC 
teen ee eee ee eee ee eee tere ne ee eee eee eee + 
Z21y | number of LUNs assigned | 20 G.TSNL 
Se Herre eee eee ee eee eee + 
23 CO SALES CONG AED ERA AMAL A IHS 22 
Se i + 
25 UZ eaddddddddddiddda 24 
Se + 
27 ‘| address of Sar vector table | 26 G.TSVA 
tee re eee eee eee eee eee Sl + 
31 | length of SST vector table in words | 30 G.TSVL 
teen ee eee ree eee eee toe - nee ee ee eee eee eee + 
33 | size (in bytes) of memory for job image | 32 G.TSTS 
terre eee eee eee eee eee tern eee ee eee eee ee eee + 
35 | system where job is running (4 = RSTS/E) | 34 G.TSSY 
terre eee ee ee eee eee terre ree eee ete ee eee + 


buf+0 


buf +4 


buf+14 


buf+16 


buf+18 


buf+20 


buf+26 


buf+30 


buf+32 


buf+34 


GTSK$ 


is the task name. The name supplied for the TASK = name 
option at the time the task was built (linked) with TKB; 
otherwise, the file name of the file being run. 


is the partition name specified for the PAR = name option at 
the time the task was built (linked) with TKB. If no such 
name was specified, the characters "GEN "(GEN followed by 
three blanks), to indicate the general partition, the default 
system-controlled partition in RSX-11M. 


is the run priority; may range from 0 to 255. This is the 
RSTS/E job priority plus 128. 


is the programmer number of the user currently running the 
program. 


is the project number of the user currently running the 
program. 


is the number of logical unit numbers (LUNs) currently 
assigned. 


is the address of the SST vector table. If buf+30 = 0, this 
word is meaningless. 


is the length of the SST vector table, in words. If there is 
no SST vector table, this word is set to 0. 


is the job size, in bytes. If I and D space is enabled, this 
size reflects only the D portion of the task. 


is the system in which the program/job/task is running: 


RSX-11D 
RSX-11M 
RSX-11S 

IAS 

RSTS/E 

VAX /VMS 
RSX-11M-PLUS 
RT-11 


NAO B® WD EH © 
noen#ut ut wa 


This value is always 4 on RSTS/E systems. 


Macro Expansion 


GTSK$ 
~ BYTE 
«WORD 


DATBUF 
63.,2 ;DIC=63., DPB SIZE = 2 WORDS 
DATBUF ;ADDRESS OF 16-WORD BUFFER 


GTSKS 


Local Symbol Definitions 
G.TSBA Buffer Address 


The monitor assigns the following offsets relative to the buffer: 


G.TSTN Task name (4) 

G.TSPN Partition name (4) 

G.TSPR Priority (2) 

G.TSGC Programmer number (1) 

G.TSPC Project number (1) 

G.TSNL Number of logical units (2) 

G.TSVA SST vector address (2) 

G.TSVL Length of SST vector table (2) 
G.TSTS Size of space for user job image (2) 
G.TSSY System being run under (2) 


DSW Return Codes 
IS.SUC Successful completion. 


IE.SDP DIC or DPB size is invalid. 


MAPS 


MAPS - Map Address Window 


The MAPS directive maps a previously created address window to an 
attached resident library. In other words, MAPS relates the virtual 
address range defined by a CRAWS directive to actual locations in 
memory within a resident library that has been attached to the job by 
an ATRGS directive. 


If the window specified is already mapped, it is unmapped from its 
previous actual memory locations and remapped to the new area. A job 
may map a maximum of seven address windows at any given time. 
Privileges Required 


None 


Macro Call 


MAPS adr 
where: 
adr is the address of an 8-word area defining the window to be 


mapped. The MAPS directive also returns information to this 
area. Two supplementary directives are available to define 
(WDBDFS) or define and fill (WDBBKS) such an area, called 
the Window Definition Block (WDB). 


Macro Expansion 


MAPS WDBADR 
» BYTE 121.,2 ;DIC=121., DPB SIZE=2 WORDS 


MAPS 


Data Passed in WDB 


Mne- Octal 
monic Offset 


Octal Mne- 
Offset monic 


LYSSSASSAISSSS AS11117 | window ID | O W.NID 
3 SEAL IMLCE RAMA LALA SAAR AA ELSE CALAESEA 2 
5 QE 4 


resident library ID | 6 W.NRID 
offset, in 32-word blocks | 10 W.NOFF 
length, in 32-word blocks | 12 W.NLEN 


access flags | 14 W.NSTS 


17 MOL TALL LOL | 16 


adr+wW.NID 


adr+W.NRID 


adr+W.NOFF 


adr+W.NLEN 


adr+w.NSTS 


is the ID of the window to be mapped (returned at the 
same location in the WDB by the CRAWS directive). 


is the ID of the resident library to which the window is 
to be mapped (returned at offset R.GID in the RDB by the 
ATRGS or CRRGS directive that attached the job to the 
resident library). 


is the offset, in 32-word blocks, from the start of the 
library where the mapping is to begin. A value of zero 
for this word indicates that the window is to be mapped 
beginning at the first byte of the library. A value of 
one indicates that the window is to be mapped beginning 
at the 33rd word of the library (starting address +64), 
and so forth. The offset cannot indicate a starting 
address past the end of a library. 


is the length, in 32-word blocks, to be mapped to the 
library. This value cannot be greater than the size of 
the window defined in the CRAWS directive with which the 
window was created. In addition, this value, combined 
with the offset value at adr+W.NOFF, cannot indicate an 
address beyond the end of the library. 


A value of zero for this word defaults to the size of 
the window or the space remaining in the library, 
whichever is smaller. 


is the access flag. When bit 1 (WS.WRT) is set, 
read/write access is allowed. A separate setting for 
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MAP$ 


access in MAPS and in ATRGS lets you attach to a library 
read/write and map a portion of the library read-only. 
You cannot, however, attach to a library read-only and 
then map to the library read/write. 


Data Returned in WDB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 
Sr Se + 
1 NAAN AAALAC LONA LEAL AM AMAA IG GMA Ae 0 
Se ee + 
3 PLLPLPPLLLPILPASPLLLALPADPATPALLTPDILTAID ILE | 2 
Hort ere ee eee eee tenn ne er ee eee ee eee + 
SLSSASIIAIAAIIIAAAIA IAA AAAI AAA ASA AAAS A117 | A 
Herr ee ee eee tern nee eee ee ee ee eee + 
PUA hhh 
Sl tenn rte ee ee eee eee + 
11 TEENA SRIG ADEA Ea CRA RAKE MLA MA SACI, 10 
[i + 
13; length setiarig mapped | 12 W.NLEN 
terre rere re ree eee Sn + 
15 | status flags | 14 W.NSTS 
ter ree eee ee eee Se + 
17 EASES LEELA SEEK AIL RAE At teh hee 16 
Se + 
adr+W.NLEN is the length, in 32-word blocks, mapped by the call. 
adr+wW.NSTS are the status flags. Bit 14 (WS.UNM) indicates, when 
set, if the window specified was unmapped before the new 
map. 


Local Symbol Definitions 

M.APBA Window Definition Block address (2) 

DSW Return Codes 

IS.SUC Successful completion. 

IE.ALG The offset and length specified are inconsistent; either the 
mapping attempted to go beyond the end of the library, or the 


length is greater than the created window. 


IE.PRI The mapping did not succeed because user privileges did not 
allow the access desired. 


IE.NVW Either the resident library ID or the address window ID is 
incorrect. (That is, the job is not currently attached to the 
specified resident library, or no address window has been 
created with the specified window ID.) 
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QIo$ 
Qrows 


QIOS and QIOWS - Queve I/O Request (and Wait) 


The QIOS and QIOWS directives do non-file-structured I/O. In the RSX 
emulation mode environment, QIO$ and QIOWS do the same thing. I/0 is 
synchronous in this environment. That is, you cannot request I/0, do 
other processing, and get an interrupt when the I/O completes. In RSX 
emulation mode, control returns to the program only when the I/0 is 
complete. 


As non-file-structured implies, the QIOS and QIOWS directives are 
useful for I/O on a terminal, card reader, paper tape reader/punch, or 
line printer. 

Privileges Required 


See discussion 


Macro Call 


QIOS 
fne,lun,[(efn],[pri),[isb],[ast][,par] 
QIOWS 
where: 
fnc is the I/O function code: 


IO.ATT Attach. In RSTS/E, opens the device specified by 
the logical unit number (lun). 


IO.DET Detach. In RSTS/E, closes the device specified by 
the logical unit number (lun). 


IO0.RAL For terminals only, performs a read in ODT mode 
(see .TTDDT in Chapter 3). 


IO.RLB Read. IO.RLB and IO.RVB do the same thing in 

IO.RVB RSTS/E. The actions performed depend on the 
device (see the section "Format and Description by 
Function Code"). 


IO.WAL For terminals only, performs a write in binary 
mode (see RECORD 4096% for terminal output, RSTS/E 
Programming Manual). 


IO.WLB Write. IO.WLB and IO.WVB do the same thing in 

IO.WVB ' RSTS/E. The actions performed depend on the 
device (see the section "Format and Description by 
Function Code"). 


QIos 
QrIows 


lun is the logical unit number; defines the device for which the 
I/O operation is to be performed. Must have been previously 
defined with an ALUNS directive. 


efn is the event flag. (The RSX emulator ignores this 
parameter. ) 


pri is the priority. (The RSX emulator ignores this parameter. ) 


isb is the I/O status block. Address of a 2-word buffer to 
which information is returned about the outcome of the I/0 
operation. The contents vary according to the function code 
and device, as the following describes. 


ast is the asynchronous exception address. (The RSX emulator 
ignores this parameter.) 


par is the parameter list. Of the form <pl,p2[,,,,p3]> for 
RSTS/E users. Form and meaning varies according to function 
code and device, as the following describes. 


Format and Description by Function Code 
QIO$ 
IO.ATT,lun[,,,isb] 
QIOws 


Opens the device specified by the logical unit number (lun). Status 
information is returned to the 2-word buffer at address isb. If the 
device is restricted, this function requires DEVICE privilege. 


oe 


| IO.DET,lun[{,,,isb] 

QIOWS 

Closes the device specified by the logical unit number (lun). Status 
information is returned to the 2-word buffer at address isb. This 
function does not require any privileges. 


QIOS IO.RLB 
,lun,,,{isb],,<stadd,size[,,,block]> 
I0O.RVB 


QIOWwSs 


For record-oriented devices in the RSX-11M environment (see GLUNS), 
IO.RLB and IO.RVB return a record (a line on a terminal, card ona 
card reader, record on a paper tape reader). The data is read into 
the buffer whose starting address is defined by stadd and whose length 
in bytes is defined by size. The amount of data read never exceeds 
the buffer size. If the buffer size is smaller than the record, the 
next IO.RLB or IO.RVB for that lun reads another buffer-full. fThe 
block parameter is omitted for these devices. 
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QIo$ 
Qrows 


For disk, IO.RLB and IO.RVB fill the buffer whose starting address is 
defined by stadd and whose length in bytes is defined by size. The 
read begins with the device cluster number specified by the block 
parameter. If block is omitted or 0, sequential reads are performed 
and the next read begins with the next device cluster. The buffer 
size should be a multiple of the device cluster size for the disk (see 
Appendix B). 


Note 
Only jobs with the necessary privileges can do 
non-file-structured disk I/O. RDNFS privilege is 
required for read-only and WRTNFS privilege is 
required for read/write non-file-structured disk I/O. 
For all devices, the isb parameter is the address of a 2-word buffer 


to which status information on the read is returned. If isb is 
omitted, no such status is returned. 


QIOS | 


QIOWws 


IO.WLB 
,lun,,,({isb],,<stadd,size[,vfc])> 


IO.WVB 


For record-oriented devices in the RSX-11M environment (see GLUNS), 
IO.WLB and IO.WVB write the contents of the buffer to the device 
specified by the logical unit number (lun). The starting address for 
the buffer is defined by stadd, and the length in bytes is defined by 
Size. For record-oriented and carriage-controlled devices, the vfc 
parameter specifies an action to be performed after the buffer 
contents are written. (The vfc parameter is a vertical format control 
character for terminals and line printers.) 


Table 5-2 lists the values for vfc and the actions taken. The vfc 
parameter is omitted for non-carriage-controlled devices. 


Table 5-2: Vertical Format Control Characters 


| 
| Single space -- Output a line feed, print the 
| contents of the buffer, and output a carriage 
| return. Normally, printing immediately 
| follows the previously printed line. 
| 
060 | Double space -- Output two line feeds, print 
| the contents of the buffer, and output a 
| Carriage return. Normally, the buffer 
| contents are printed two lines below the 
| previously printed line. 
| 
061 | Page eject -- Output a form feed, print the 
| contents of the buffer, and output a carriage 
| return. 
| 
053 | Overprint -- Print the contents of the buffer 
| and output a carriage return. Normally 
| overprints the previous line. 
| 
044 | Prompting output -- Output a line feed and 
| print the contents of the buffer. This mode 
| of output is intended for use with a terminal 
| on which a prompt message is output and input 
| is then read on the same line. 
| 
000 null | Internal vertical format -- Print the buffer 
| contents without adding vertical format 
| control characters. In this mode, more than 
| one line of guaranteed contiguous output can 
| be printed for each I/0 request. 


For disk, IO.WLB and IO.WVB write the contents of the buffer to disk, 
beginning at the device cluster number specified by the block 
parameter. If block is omitted, sequential writes are performed. The 
next write (for sequential writes) begins with the next device 
cluster. The buffer size must be a multiple of the device cluster 
size. 


Note 


No job can write to disk in non-file-structured mode 
while any other user is accessing the disk. 


QIOS 
Qrows 


For all devices, the isb parameter defines the starting address of a 
2-word buffer to which status information on the write is to be 
returned. If you omit isb, no such status information is returned. 


Contents of I/0 Status Buffer 


The general format of the information returned to the 2-word status 
buffer defined by isb is: 


Herre ee ee eee eee Ss + 
| (terminal I/O code) | general I/0 code | 
Se 5 + 
| number of bytes read or written | 
tenner eee ee ee eee eee eee i + 


The first word contains information on the success or failure of the 
I/O operation requested. As with SDSW, you can use mnemonic codes to 
test this word. The Task Builder resolves the mnemonics 
automatically. 


For all devices and operations except terminal reads, you test the 
low-order byte of the first word to determine the I/0 status code. 
Successful terminal reads provide additional information on what 
character terminated the line typed at the terminal. For terminal 
reads, you test the low-order byte first to see if the read was 
successful (IS.SUC). If it was, you can then test the entire first 
word to find out if the line was terminated with a carriage return 
(IS.CR) or an ESC character (IS.ESC), which is called ALTMODE on some 
terminals. 


The second word of the block contains the number of bytes read or 
written, if the read or write was successful. No information is 
returned in this word for IO.ATT and IO.DET operations. 


The following section describes the I/O return codes. IS.CR and 
IS.ESC are full-word values; the others are tested by the low-order 
byte only. 


Note 


The RSX emulator does the requested I/O operation 
using the non-file-structured OPNFQ subfunction of 
CALFIP, the CLSFQ subfunction of CALFIP, .READ, and 
.WRITE. It does not clear the FIRQB or XRB when it 
returns control to the user program. The codes given 
in square brackets [] are the RSTS/E errors that are 
returned to the emulator. You can do further 
checking in the case of IE.BAD, for example, by 
checking byte 0 of the FIRQB. 


QIos 
Qrows 


Return Codes 


IS.SUC 


IE.BAD 


IE.DAA 


IE.DNR 


IE.EOF 


IE.EOT 


IE.PRI 


IE.NLN 


IE.RSU 


IE.VER 


Successful completion of I/O operation. For terminal reads, 
you can determine the terminating character of the line by 
testing the full first word of the I/0 status buffer for: 


IS.CR The terminal line was terminated with a carriage 
return/line feed combination. (The terminating 
Characters are not included in the character count in 
the second word. They do appear in the input buffer.) 


IS.ESC The terminal line was terminated with an ESC (called 
ALTMODE on some terminals). (The terminating 
character is not included in the character count in 
the second word. It does appear in the input buffer.) 


This code is returned by the RSX emulator when an error occurs 
on the I/O operation that did not fit into any of the error 
categories diagnosed. To determine the RSTS/E error, examine 
byte 0 of the FIRQB. 


An open (IO.ATT) was attempted for a device that this job has 
already opened. The device must be closed (IO.DET) before it 
can be opened again. [NOTCLS] 


Some hard device I/O error occurred (a read for an off-line 
device, a write for a physically write-locked device, and so 
forth). [HNGDEV] 


An end-of-file (EOF) mark, record, or control character 
(CTRL/Z for terminals) was recognized on a read operation. 
[EOF] 


No more room is available on the device for a write operation 
(end of paper tape, end of magtape, not enough disk space 
available, and so forth). [NOROOM] 


Privilege violation. A job with insufficient privileges 
attempted to read or write to disk while the disk was in use. 
[PRVIOL ] 


A close (I0.DET) was attempted for a device that was not open. 
[ NOTOPN ] 


Shareable resource in use. The device is not available; it is 
assigned to another user. [NOTAVL] 


Unrecoverable error, such as parity error, bad card column, 
and so forth. [DATERR] 


QIos 
QIows 


Macro Expansion 


QIO$ IO.RVB,7,,,IOSTAT, ,<IOBUFR,80.> 

- BYTE Ly k2s ;DIC=1, DPB SIZE = 12. WORDS 

- WORD IO.RVB ;FUNCTION CODE FOR READ 

-WORD 7 ;LOGICAL UNIT NUMBER 7 

- BYTE 0,0 ;EFN,PRI IGNORED IN RSTS/E 
-WORD IOSTAT 71/0 STATUS BUFFER 

- WORD 0 ;AST IGNORED IN RSTS/E 

-WORD IOBUFR :BUFFER ADDRESS 

- WORD 80. ;BYTE COUNT = 80. 

- WORD 0 7;NO VFC NEEDED FOR READ 

-WORD 0 ;THIS PARAM. IGNORED IN RSTS/E 
-WORD 0 ;THIS PARAM. IGNORED IN RSTS/E 
-WORD 0 ;NO BLOCK FOR THIS INVOCATION 


The expansion for QIOWS is the same except that the DIC = 3. 
Local Symbol Definitions 

Q.IOFN I/0 function code (2) 

Q.IOLU Logical unit number (2) 

Q.IOEF Event flag number (1) 

Q.IOPR Priority (1) 

Q.IOSB Address of I/O status block (2) 

Q.IOAE AST address (2) 

Q.IOPL Parameter list (6 words) (12) 

DSW Return Codes 

IS.SUC Successful completion. 

IE.LUN Unassigned logical unit number (lun). Use ALUNS. 


IE.ILU Invalid logical unit number (lun). Must be in the range 0 to 
14. 


IE.SDP DIC or DPB size is invalid. 


RDBBKS 
RDBDFS 
RDBBKS$ and RDBDFS - Define and Fill RDBs 


Two directives are available for use with resident library definition 
blocks (RDBs): RDBDFS and RDBBKS. 


The RDBDFS directive assigns literal values to the offsets and status 
bit mnemonics shown for the RDB areas for the ATRGS and DTRGS 
directives. You can use these mnemonics to reference offsets and bit 
values in an RDB you have allocated space for in your program. 

The RDBBKS directive defines these offsets and, in addition, generates 
code to allocate space for the RDB and fills it with values you 
specify in the call. 

Privileges Required 


[Not applicable] 


Macro Call 


RDBBKS Ssize,libnam,,status,prtcde (for read/write access) 
sia RDBBKS size,libnam,,status,prtcde (for read-only access) 
where: 

size is the size of the dynamic region to create, if defining a 


RDB to create a dynamic region. 


libnam is the name of the resident library to be attached or the 
dynamic region to be created. 


status is the region status to be placed in the RDB. The following 
are defined status bits: 


RS.ATT When creating a dynamic region, setting this bit 
indicates that the user wants the region attached on 
creation. Note that RSTS/E forces this bit to be 
set when creating an unnamed dynamic region. 


RS.NDL When creating a dynamic region, setting this bit 
indicates that the region is not automatically 
removed on the last detach. Note that RSTS/E forces 
this bit to be set when creating an unnamed dynamic 
region. 

RS.RED Map with read-only access to library. (for ATRGS$) 

RS.WRT Map with read/write access to library. (for ATRGS) 


prtcde is the protection code (in RSX format) of the dynamic region 
to be created. 
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RDBBKS 
RDBDFS$ 


Macro Expansion 


RDBBKS' SIZE,DATLIB,,<RS.WRT>,167000 
-WORD 0 

-WORD SIZE 

~-RAD50 /DATLIB/ 

-WORD 0 

-WORD 0 

-WORD RS .WRT 

-WQRD 167000 


(RS.WRT is assigned to a literal value of two, so bit 1 is set in the 
seventh word of the RDB, requesting read/write access.) 


In addition, all the offsets necessary to reference the data returned 
in the RDB by ATRGS or DTRGS are generated. For example, you can use 
the mnemonic RS.UNM to test bit 14 of the word at offset R.GSTS in the 
RDB after execution of a DTRGS directive. RS.UNM is assigned to a 
literal value of 40000 (octal) by the RDBBKS directive. 


SCCASS 


SCCASS - Specify Control/C AST 


The SCCASS directive (actually, a macro) lets you specify an address 
to which control is to be transferred if the user types a CTRL/C while 
the program is executing. Only the $S form is allowed, because no DPB 
is ever generated. The SCCASS directive is unique to the RSTS/E 
environment; no similar directive exists for the RSX-11M operating 
system. 


The SCCASS expands to code that takes the address specified and stores 
it in location 24 (part of the first 512 bytes of memory used by the 
run-time system; see Chapter 4). The RSX run-time system checks this 
location when a CTRL/C asynchronous exception occurs, and if it is 
nonzero, clears the word and transfers control to the location that 
was specified. If this word is zero, the RSX run-time system falls 
back to its own processing of CTRL/C exceptions. Thus, SCCASS is a 
one-time operation; you must reset the handler as part of the 
exception-processing routine, if desired. 


Your routine can handle the CTRL/C in any way it sees fit. An RTI 
instruction returns control to the point where it left off at the time 
of the exception. The stack upon entry to such a routine is: 
SP—»> (PC) at the time exception occurred 
(PS) at the time exception occurred 
word to which SP pointed before the exception 
Privileges Required 
None 
Macro Call 
SCCASS [arg] 
where: 
arg contains the address (usually specified in the form "#addr") 
to which control passes if the user enters a CTRL/C 
combination at the job’s terminal. Word 24 is cleared, 
indicating that the RSX run-time system is to handle such 
traps. 


Macro Expansion 


SCCASS #CTRAP 
MOV #CTRAP, @#24 


If you omit the address, the expansion is: 


SCCASS 
CLR @#24 


SCCASS 


Local Symbol Definitions 
None 
DSW Return Codes 


None. (SCCASS does not execute an EMT; control does not pass to the 
RSX emulator when SCCASS is executed. ) 


SFPAS 


SFPAS - Specify Floating-Point-Processor Exception Address 
The SFPAS directive tells the RSX emulator one of two things: 


o The job wants to handle FPP exceptions itself. The RSX 
emulator passes control to the address specified in the 
directive when such an asynchronous exception occurs. 


The FPP available on all PDP-11 processors that can run 
RSTS/E, except the PDP-11/35 and 40. The FPP executes 
concurrently with the PDP-11 central processor. Thus, an 
error in the FPP unit occurs asynchronously with the 
execution of the PDP-11 CPU. 


o The job does not want to handle FPP exceptions. The address 
is omitted in the directive. In this case, if an FPP 
exception occurs, the RSX emulator aborts the job, and 
displays the error message ??Reserved instruction trap on the 
job’s terminal (TI:). 


If you specify an address in the SFPAS directive, control passes to 
the address when an FPP exception occurs. The stack has the following 
information: 


sP—> FEA 
FEC 
(DSW) at the time the exception occurred 
(PC) at the time the exception occurred 
(PS) at the time the exception occurred 
word to which SP pointed before the exception 
Your routine can process the exception in any way it sees fit. To 
exit from the exception-handling routine, pop the FEA and FEC from the 
stack and issue an ASTXS directive. 
Privileges Required 
None 
Macro Call 
SFPAS [add] 


where: 


add is the address to which control passes when an FPP exception 
occurs. 


SFPAS 


Macro Expansion 


SFPAS FLTAST 
- BYTE Lil gee ;DIC = 111., DPB SIZE = 2 WORDS 
- WORD FLTAST ;ADDRESS OF FLOATING POINT AST 


Local Symbol Definitions 

S.FPAE Exception handler entry address (2) 
DSW Return Codes 

IS.SUC Successful completion. 


IE.SDP DIC or DPB size is invalid. 


SPNDSS 


SPNDSS - Suspend 
The SPNDSS directive instructs the system to suspend the execution of 
the issuing program. A program can only suspend itself, it cannot 
suspend any other program. The program is restarted when the user 
types anything terminated by a RETURN or other delimiter (for example, 
LINE FEED). 
Note 

RSTS/E implements this directive using the .READ 

directive to the job’s terminal (channel 0). Thus, 

if you are using special terminal modes (binary 

input, echo control, and so forth), the SPNDSS 

directive clears these modes. 
Because this directive requires only a l-word DPB, DIGITAL recommends 
the $S form of the macro. It requires less space and runs with the 
same speed as the DIRS macro. 
Privileges Required 
None 
Macro Call 

SPNDSS [err] 

where: 


err is the error routine address. 


Macro Expansion 


SPNDSS ERR 

MOV (PC)+,-(SP) ;PUSH DPB ONTO THE STACK 

- BYTE Sigel ;SPNDSS MACRO DIC, DPB SIZE=1 WORD 
EMT 377 ;TRAP TO THE EMULATOR 

BCC +6 ;BRANCH IF DIRECTIVE SUCCESSFUL 
JSR PC,ERR ;OTHERWISE, CALL ROUTINE "ERR" 


Local Symbol Definitions 

None 

DSW Return Codes 

IS.SPD Successful completion; that is, the task was suspended. 
IE.ADP Part of the DPB is out of the issuing task’s address space. 
IE.SDP DIC or DPB size is invalid. 
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SVDBS 


SVDBS$ - Specify SST Vector Table for Debugging Aid 


The SVDBS directive, like the SVTKS directive, defines a table of 
addresses to which control is to pass when certain synchronous 
exceptions occur. When a synchronous exception occurs, the RSX 
emulator first checks the table defined with SVDBS to see if an 
address has been specified for that trap. If so, control is passed to 
that address. If not, the emulator then checks the table defined with 
SVTKS (if any). 


In other words, the SVDBS sets up an SST vector table whose entries, 
if nonzero, override (but do not destroy) any SST vector table entries 
defined with SVTK$. The SVDBS directive is useful within a debugging 
routine that uses BPT instructions (for example, to set breakpoints). 
With SVDBS, the debugging routine can divert breakpoint traps to 
itself, regardless of SVTKS directives in other modules of the job. 


For example, the Octal Debugging Tool (ODT) object module uses the 
SVDBS$ directive to divert exceptions to itself, regardless of what may 
have been requested with SVTKS in other modules. This makes it 
possible to debug without changing your source code; you can link with 
ODT, use ODT to insert breakpoints, test and debug, and when finished, 
relink without ODT. Note that it is not necessary to change source 
code to debug, only to relink: the SVDBS directive makes this 
possible. 


Note 
The ODT object module (the file ODT.OBJ) can be 
linked to user modules with the RSTS/E Task Builder 
(TKB) using the /DA switch, as described in the 
RSTS/E Task Builder Reference Manual. ODT.OBJ is 
different from ODT.BAC, which is a BASIC-PLUS utility 
in RSTS/E. The commands and syntax for ODT.OBJ are 
described in the RSX/IAS ODT Reference Manual. 


To avoid interfering with ODT, do not use the SVDBS$ 
directive in a user program. 


Privileges Required 
None 
Macro Call 
SVDBS [adr,len] 
where: 
adr is the address of the SST vector table. If adr and len are 
both omitted, any SST vector table previously defined with 


an SVDBS directive will be deassigned; that is, the emulator 
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SVDBS 


will not check for SVDBS addresses. (A previously executed 
SVTKS remains in effect.) 


len is the length of the SST vector table, in words. You can 
specify up to eight addresses. If you want to use only the 
third, you could save space by using a len of three, rather 
than a len of eight and filling the last five words of the 
buffer with zeros. Specifying a length greater than eight 
has the same effect as a length of eight. 


Vector Table Format 


A nonzero value for a word is the address to which control passes when 
that particular exception occurs. A zero value for a word indicates 
that you have no interest in handling that exception. Should such a 
exception occur, the emulator checks the vector table assigned by 
SVTKS, if any. If there is no SVTKS vector table, the emulator aborts 
the job and displays an error message at the job’s terminal. 


Octal Octal 
Offset Offset 
tere ee ee ee ee ee eee tee eee eee ee eee eee eee + 
1 | odd address or nonexistent memory error | 0 
Se tee eer ee ee ee eee ee eee + 
3 | memory protection violation Le 
+---- eee eee eee ee ee eee terre ee eee eee ee eee + 
5 | T-bit trap or execution of a BPT instr. | 4 
tee ee ee ee ee ee eee terre en ree ee ee eee ee eee + 
7 | execution of an IOT ietewerien: | 6 
tree ee ee eee ee eee ee tee ee ee eee ee ee eee eee + 
Lk | Seccueicn of a reserved instruction | 10 
terre ee re ee ee ee eee eee terre ee eee ee eee ee eee + 
13 |execution of a non-RSX, non-RSTS EMT instr.| 12 
tere ree ee eee ee ee eee tee eee eee ee ee eee eee + 
15 | execution of a TRAP instruction | 14 
tee ee ee ee ee eee ee ee eee tere ere ee ee ee ee eee + 
17 | PDP-11/40 FPP exception | 16 
tener ee ee ee eee eee eee tere ere ee ee ee ee ee eee + 


Macro Expansion 


SVDB$ SSTTBL, 3 

- BYTE 103.,3 ;DIC=103. ,DPB SIZE = 3 WORDS 
» WORD SSTTBL ;ADDRESS OF SST TABLE 

«WORD 3 :;SST TABLE LENGTH = 3 WORDS 


SVDBS 


SVTKS 
Octal Octal 
Offset Offset 
tee ee ee ee ee ee ee eee tenn eer ee ee ee eee eee ee + 
1 | odd address or nonexistent memory error | 0 
Herre ree ee eee eee eee tee re eee ee ee ee eee eee + 
34 memory protection violation | 2 
tee ee ee ee ee ee ee eee Se “+ 
5 | T-bit trap or execution of a BPT instr. | 4 
i Se ~+ 
7 | execution of an IOT instruction | 6 
Sl tern er re eee ee eee eee + 
11 | execution of a reserved instruction | 10 
tenn eee eee ee eee tee eee eee eee eee eee eee + 
13 |execution of a non-RSX, non-RSTS EMT instr.| 12 
tener ee ee eee ee ee eee eee tere ee ee ee eee eee eee ~+ 
15 | execution of a TRAP instruction | 14 
t----- eee eee eee ee eee Se + 
LT | PDP-11/40 FPP exception | 16 
te ee -eee e e e e ee e ee eeeee t--- eee eee ee ee ee ee eee + 


The contents of the program status register and the program counter 
(PS and PC) at the time of the exception have been pushed on the stack 
when the exception-handling routine is entered. Certain other values 
may have been pushed on the stack. The values depend on the 
exception. If the exception was a memory protect violation, the stack 
contains: 


(SP)— > Instruction backup register (SR1) 
Virtual PC of the faulting instruction (SR2) 
Memory protect status register (SRO) 
(PC) at time of exception 
(PS) at time of exception 


Note 


The RSX emulator returns zero for SRO and SR1; SR2 
contains the PC at the time of the exception. 


If the exception was a TRAP instruction or EMT other than 377, the 
stack contains: 


(SP)—— Instruction operand (low-order byte) times 2, high-order bits 
cleared 
(PC) at time of exception 
(PS) at time of exception 


All items except the (PS) and (PC) must be popped from the stack 
before the exception-handling routine exits. You can then return 
control to the point where execution left off with an RTI or RTT 


a ee i 


Macro Expansion 


SVTKS 
BYTE 
«WORD 
- WORD 


SSTTBL, 4 

£05.53 ;DIC = 105., DPB LENGTH = 3 WORDS 
SSTTBL ;ADDRESS OF SST TABLE 

4 ;SET TABLE LENGTH = 4 WORDS 


Local Symbol Definitions 


S.VTTA 


S.VTTL 


Table address (2) 


Table length (2) 


DSW Return Codes 


IS.SUC 


IE.SDP 


Successful completion. 


DIC or DPB size is invalid. 


SVTKS 


UMAPS 


UMAPS - Unmap an Address Window 

The UMAPS unmaps a specified address window from a resident library. 
The unmapping does not eliminate the window (created with a CRAWS 
directive) or release the APRs used by the window. The virtual 
address window can now be remapped to new actual memory locations with 
the MAPS directive. 

Privileges Required 

None 


Macro Call 


UMAPS adr 
where: 
adr is the address of an 8-word area defining the window to be 


unmapped. The UMAPS directive also returns information to 
this area. Two supplementary directives are available to 

define (WDBDFS) or define and fill (WDBBKS) such an area, 

called the window definition block, or WDB. 


Macro Expansion 


UMAPS WDBADR 
. BYTE 123.,2 :DIC=123., DPB SIZE=2 WORDS 
.WORD WDBADR 


Data Passed in WDB 


Mne- Octal Octal Mne- 
monic Offset Offset monic 


LiUSSTSTSAITLI IAAT AAT SF | window ID | O W.NID 
BOIAASEITITTSS LIISA AASAAA AAAI AAI AAI AALA IES ST 
5 AONE LEU KULMEL EE Neh MEA RGL AL 4 


LL YSSSAASSAAATAA TATA AAA AAA AAA ATS | 8 


UMAPS 


adr+W.NID is the ID of the window to be unmapped (returned at the 
same location in the WDB by the CRAWS directive). 


Data Returned in WDB 


Mne- Octal Octal Mne- 
monic Offset aaa monic 


1 Wada 0 
3 Weeddaaaadadda 2 


11 Vadddddddaidia 10 
i as + 


13 Veaadadadidiida 12 


15 | status flac | 14 W.NSTS 


adr+W.NSTS is the status flag. Bit 14 = 1 (WS.UNM) if the window 
specified was successfully unmapped. 


Local Symbol Definitions 


U.MABA Window definition block address (2) 


DSW Return Codes 
IS.SUC Successful completion. 


IE.ITS The window ID specified is either invalid (outside the range l 
to 7) or not currently mapped. 


WDBBKS$ 
WDBDFS$ 
WDBBKS and WDBDFS$ - Define and Fill WDBs 


Two directives are available for use with Window Definition Blocks 
(WDBsS): WDBDFS and WDBBKES. 


The WDBDFS directive assigns literal values to the offsets and status 
bit mnemonics shown for the WDB areas for the CRAWS, ELAWS, MAPS, and 
UMAPS directives. You can use these mnemonics to reference offsets 
and bit values in a WDB you have allocated space for in your program. 
The WDBBKS directive defines these offsets and, in addition, generates 
code to allocate space for the WDB and fills it with values you 
specify in the call. 

Privileges Required 

[Not applicable] 

Macro Call 


WDBBKS apr,siz,rid,off,len,<bitl![bit2!bit3]> 


where: 
apr is the base APR. 
siz is the size of the window. 
rid is the resident library ID. 
off is the offset into the library, in 32-word blocks. 
len is the length to be mapped. 


bit... are the mnemonic values for bit settings, separated by 
exclamation points. The following mnemonics are defined for 
CRAWS : 
WS.MAP Indicates the window is to be mapped 
WS.WRT Means map with read/write/access 


WS.RED Means map with read-only access 


WDBBK$ 
WDBDF$ 
Macro Expansion 


WDBBKS 7,128.,0,0,0,<WS.MAP!WS.RED> 
- BYTE 0,7 


-WORD 0 
- WORD 128. 
.WORD 0 
-WORD 0 
-WORD 0 


-WORD WS.MAP!WS.RED 


When used in a CRAWS directive, this WDB creates a window 4K words 
long (128 by 32-word blocks) in APR 7. The call also specifies an 
offset and map length of zero and read-only mapping. Note that to use 
this WDB, you have to supply the resident library ID, which you get 
from the RDB returned by an ATRGS call. To fill in the library ID, 
move the word at offset R.GID in the RDB to offset W.NRID in the WDB. 


The WDBBKS directive also defines the offsets and bit settings that 
the ELAWS, MAPS, and UMAPS descriptions refer to. 
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WSIGS 


WSIGS ~- Wait for Significant Event Flag 
The WSIGS directive is included for compatibility with RSX-11M. In 
RSX-11M, some recoverable error conditions require waiting for a 
significant event to happen, at which time a retry of the operation 
that failed may succeed. On a RSTS/E system, any events that may be 
termed significant within the RSTS/E monitor are transparent to user 
jobs. Hence, the WSIGS directive in RSTS/E merely causes the calling 
job to sleep for one second. The job can then retry whatever 
operation failed previously. 
Privileges Required 
None 
Macro Call 

WSIGS$ 


Macro Expansion 


WSIGS 
.BYTE 49.,1 ;DIC=49., DPB SIZE=l1 WORD 


Local Symbol Definitions 

None 

DSW Return Codes 

IS.SUC Successful completion. 


IE.SDP DIC or DPB size is invalid. 


WTSES 


WTSES - Wait for Single Event Flag 


The WTSES directive is included for compatibility with RSX-11M, in 
which some programs are written with a QIOS followed by a WTSES, to 
cause the program to wait until the I/O is complete. This has the 
same effect as a QIOWS directive. Since all I/O is synchronous in 
RSX-emulation mode, QIOS performs the same as QIOWS. Thus, the WTSES 
directive returns immediately; it performs no operation in RSTS/E. 


Privileges Required 
None 


Macro Call 


WTSES efn 
where: 
efn is the event flag number. (The RSX emulator ignores this 


parameter. ) 


Macro Expansion 


WTSES 0 
. BYTE 41.,2 s;DIC=41., DPB SIZE = 2 WORDS 
.WORD 0 :FLAG IGNORED IN RSTS/E 


Local Symbol Definition 

W.TSEF Event flag number (2) 
DSW Return Codes 

IS.SUC Successful completion. 


IE.SDP DIC or DPB size is invalid. 
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Chapter 6: RT11 Run-Time System Environment 


The RT11 run-time system emulates the single-job monitor of the RT-11 
operating system on RSTS/E systems. You can use many of the 
programmed requests available to MACRO programmers on RT-11 systems. 
In addition, the RT1l1 run-time system provides some directives, suited 
to the RSTS/E environment, that are not available for the RT-1ll 
operating system. 


The size limit for programs running under the RT1l1 run-time system is 
27K words, slightly less than the 28K words allowed by the RT-11 
operating system. The run-time system itself takes a 4K-word high 
segment. It also uses 1K words in the user job image area as a 
scratch pad. As Chapter 2 notes, run-time systems are usually mapped 
read-only, so they can be shared by more than one user on a RSTS/E 
time-sharing system. However, the RT-11 operating system lets you 
access certain areas within the resident monitor. Thus, to allow a 
similar capability under RSTS/E, these areas must be located in the 
user job image area, which is mapped read/write. 


If you use the RT1l1l directives (see Chapter 7), you must assemble your 
program with the MACRO assembler and link the modules with the LINK 
linker. The RSTS/E RT11 Utilities Manual describes how to run MACRO 
and LINK to assemble and link your program. 


Advantage: Transportable Code 


The RT1l1 directives are useful if you are coding a program to be run 
under both the RT-11 and RSTS/E operating systems. RSTS/E emulates 
the majority of the RT-11 single-job programmed requests. Of those 
which are not, most are ignored on RSTS/E systems, including the 
foreground/background (FB) and extended memory (XM) calls. That is, 
most RT11 directives do not cause errors on RSTS/E systems (see 
Chapter 7 for a list of exceptions). 


Those RT11 requests that are emulated are fitted to the RSTS/E 
environment. For example, under the RT-11 operating system, there are 
three types of read: 


© .READ -- Initiates a read operation and transfers control 
back to the user program; the read may or may not be 
complete. 


© .READW -- Initiates a read operation and transfers control 
back to the user program only after the read operation is 
completed. 
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Oo .READC Initiates a read 
the user program; 


then, when the read is complete, 


operation and transfers control to 
transfers 


control to a user-specified completion routine. 


Under RT1ll emulation, 


and .READW are implemented the same 
wait." The .READC transfers control 
read operation finishes. 


The significance of the differences 
If you are transporting an existing 
can generally be confident that the 


If you are developing a program for 


all I/O is synchronous; that is, 
returned to the user program only when the I/O is complete. 


control is 
So, 
under RSTS/E: as a "read and 
to the completion routine when the 


. READ 


depends on what you want to do. 
program from RT-11 to RSTS/E, you 
program works as it should. 


RSTS/E only, you do not have to be 


concerned with how the directives work on RT-11. You can choose .READ 
or .READW: both work the same. You can also choose .READC if, for 
example, you wanted to code one completion routine to be used after 
different read operations. 


If you are developing a program on RSTS/E to be run under RT-1l, or 
both RSTS/E and RT-11, you need to know how the directives work under 


RT-l11 and under RSTS/E. You can choose between .READ, .READW, and 
-READC according to what they do on both systems. 
Chapters 6 and 7 describe what RT1ll directives are available, as well 


as what they do under RSTS/E. See the RT-11 Programmer’s Reference 
Manual for a complete description of how these directives work in the 
RT-11 operating system environment. 


You can also transport assembled (binary) programs from RT-11 systems 
to RSTS/E systems, if you keep in mind the limitations of the emulated 
RT11 run-time system environment. You must change the run-time system 
name that RSTS/E maintains in the file directory entry for each 
runnable file. The easiest way to do this is with the /RUNTIME_SYSTEM 
qualifier in COPY. For example: 


COPY MTO:*.* *.*/RUNTIME_SYSTEM=RT11 
This command transfers all files on magnetic tape unit 0 to your 
account on the public disk structure as files to be run under the RT1l 


run-time system. 


For binary files that have already been transferred to your system, 
type: . 


SET FILE file.typ/RUNTIME_SYSTEM=RT11 
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General Services 
Besides transportable code, the RT11l emulator provides: 


o Simple input/output. The I/O operations under the RT1l 
run-time system are simple to code and include 
file-structured input/output operations. 


o Fast program development. The LINK linker executes faster 
than its RSX emulator counterpart TKB. However, LINK does 
not provide as many features. 


System Macro Library 


The RT1l1 emulator directives that you code into your program are macro 
calls; MACRO-11 expands them into executable code at assembly time. 
The macro expansions for the RT1ll1 emulator directives are contained in 
the system macro library (SSYSMAC.SML). You can name this library 
file in the input-file list when you assemble your program. For 
example: 


MACRO OBJ,OBJ=SSYSMAC.SML/M,SRC1,SRC2 


(MACRO-11 searches the library automatically to resolve undefined 
symbols, so this is not really necessary.) 


However, you must use the MACRO-11 .MCALL directive in your code to 
define the directives you use as external macros needed to assemble 
the source program. The .MCALL must appear before the first directive 
is called. For example: 


-MCALL .READ, .DATE,.... 


- DATE 


Alternatively, you can enable automatic macro library search using the 
~-ENABL MCL macro directive. See the PDP-l1l MACRO-1ll Language 
Reference Manual for details. 


Note that some RT11 emulator directives have the same form as general 
monitor directives (.DATE, for example). If you want to use the RT1l1l 
.DATE, specify it in an .MCALL directive. Then, regardless of whether 
you assemble with the prefix file COMMON.MAC, the .DATE is expanded 
from the system library as a call to the RT1l1l run-time systen. 
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If you want the general monitor .DATE, do not specify .DATE in an 
-MCALL directive. Instead, use the special prefix emulator trap (EMT) 
instruction (EMT 377) immediately before the .DATE call, and assemble 
with COMMON.MAC. 


Note 


You must precede all general monitor directives that 
you use with an EMT 377. RT1ll uses EMTs in the range 
0 to 100, the same range used by the RSTS/E general 
monitor directives. To bypass the general monitor 
calls, the RT11 run-time system defines a special 
prefix EMT for the monitor (see Chapter 2), so all 
EMTS except those preceded by an EMT 377 are 
processed by the RT11 run-time system. 


You should not use the general monitor calls .CHAIN, 
-EXIT, .CORE, .RTS, .FSS, .RUN, or .CCL froma 
program running under control of the RT11 run-time 
system. Results from using these directives under 
RT11 emulation are unpredictable. 


Directive Processing 


It is easier to understand how you specify RT1ll directives and their 
arguments if you first understand how the directives are expanded at 
assembly time, and how they are processed by the RT11 run-time system 
at execution time. 


Generally, the expansions end with an EMT instruction passing control 
to the RSTS/E monitor. The monitor then passes control to the RT11l 
run-time system for processing. 


Note 


The RT11 run-time system has the PF.EMT bit set in 
the P.FLAG word in the pseudovector region (see 
Chapter 2). Thus, the RT11 run-time system can use 
all possible values in the low byte of the EMT 
instruction, just as the RT-11 operating system does. 
The low-byte of the P.FLAG word is set to 377, which, 
in combination with the setting of the PF.EMT bit, 
defines the special prefix EMT 377. 


The RT1l1l run-time system examines the low byte of the EMT instruction 
to determine either the action to be performed or the place to look 
for information that defines the action to be performed. 
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For example, if the call translates to code ending in an EMT in the 
range 340 to 357, the RT11l run-time system determines the action to be 
performed from the EMT and looks in general register RO and/or on the 
stack for other arguments used in the call. 


If, on the other hand, the call translates to an EMT 374 instruction, 
the RT11 run-time system looks in RO for a one-byte function code and, 
if necessary, a one-byte argument. For an EMT 375 instruction, the 
RT11 run-time system looks in RO for the address of an argument block. 
It then examines the argument block to find the function code defining 
the action and whatever other arguments it expects, depending on the 
function. 


Table 6-1 summarizes the EMTs that the RTl1 run-time system processes. 
Unless you want to bypass the directive expansions and load RO and 
other arguments yourself, Table 6-1 is important to you because: 


o All the directives use general register RO. You must 
preserve the contents of RO, if necessary, by saving and 
restoring the contents before and after issuing a directive. 
Some directives return information to RO; otherwise, the 
contents of RO are unpredictable upon completion of a call. 
All other general registers are preserved as you left them. 


o Some of the directives require that you allocate space in 
your program for arguments. The expansions for such 
directives fill the argument block you specify in the call 
with the values you specify as other arguments in the call 
(see the next section "Call Forms"). 


If an error occurs when a directive is processed, control returns to 
the user program with the carry bit set in the PSW and an error code 
in byte 42 of the low 512. bytes of memory. 
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Reserved; this is the special prefix EMT. You must 
code this EMT immediately before any of the general 
monitor calls in Chapter 3. 

EMT 376 Used internally by the RT1l run-time system. Never 
execute this EMT from a user program; the program 
aborts with an error. The error message displayed 
is: 

?M -OVLY error at user PC nnnnnn." 

EMT 375 Indicates a call that has several arguments: RO 
contains the address of the first byte of an 
argument block. 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| Indicates a call with one argument. RO contains a 
| function code in the high-order byte and the 
| argument in the low-order byte. 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


(RO) = | function code | argument | 


EMTs 372-373 Ignored by the RT1l run-time system. Do not use 
these EMTs; they are reserved for future use by 
DIGITAL. 

EMTs 360-371 EMTs specific to the RT11l run-time system under 
RSTS/E; not available under the RT-11 operating 
system. 

EMTs 340-357 Indicates a directive that expects arguments either 
on the stack, in RO, or both. 

EMTs 0-337 Indicates a directive used by Version 1.0 of the 
RT-11 operating system. These EMTS are also 
recognized by the RT11 run-time system. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| EMT 374 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


RT11 Run-Time System Environment 


Call Forms 


Chapter 7 shows RT1ll directive calls in two basic formats: those with 
an area argument and those without. The area argument indicates that 
the call uses an argument block. You must allocate space for the 
argument block. 


Format for Calls Using Argument Blocks 


The previous section describes how directives with an area argument 
use an argument block. Chapter 7 shows the format for these 
directives as: 


~-RTCALL area, argl, arg2, ...., argn 
The area argument is the address of the first byte of the area you 
have set aside for the argument block. The remaining arguments (argl, 
arg2, and so forth) are the values needed for the call. The RT11l 
emulator places them in the argument block at execution time. 


In general, the argument block format is: 


Herr eee eee eee ee Si + 
| function code | channel number | <=—(R0) 

5 5 + 

| argument 1 | (RO) + 2 

tee ee ee eee eee eee Se + 

| argument 2 | (RO) + 4 

terre eee eee eee eee Se + 

| | 

| | 

| . | 

Hore eeeeeee eeeeee +e - eee eee eee eee eee + 

| argument n | (RO) + n*2 
tee ee eee eee eee Se + 


RO points to location x. The high byte (location x+l) contains the 
function code defining the action to be performed. The low byte 
defines a channel number, if one is needed for the call. Remaining 
arguments, if any, are stored in subsequent words. 


Consider the hypothetical directive .HYPOT, using four arguments 
including the area argument: 


-HYPOT area, argl, arg2, arg3 
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If you were to specify all four arguments in the call, at assembly 
time MACRO-11 expands the call to a code that: 


o Moves the area argument (an address) to RQ. 


Oo Moves the function code for .HYPOT to the address specified 
by (RO)+1, and, if a channel number is used, moves that 
channel number to (RO). (The notation (x) means the contents 
of x -- thus the channel number is moved to the address 
specified by the contents of RO.) 


o Moves remaining arguments to subsequent words in the argument 
block. 


Oo Executes an EMT 375. 


Thus, all of the arguments for this form should be appropriate as 
operands in MOV instructions. For example: 


AREA: .WORD 0,0,0 


~-HYPOT #AREA,#4,NUMNUM, #300 
Under certain conditions, you can leave out arguments in directives 
using an argument block. If you leave out area, for example, you must 
load RO with the address of the argument block yourself, before 
executing the directive. For example: 


MOV #AREA, RO 
-HYPOT ,#4,NUMNUM, #300 


If you leave out any of the other arguments, the expansion does not 
load any new values into those positions in the argument block; those 
words are left untouched. For example: 


AREA: - WORD 0,0,0 


-HYPOT #AREA, ,NUMNUM, #300 
The execution of .HYPOT uses the value 0, the contents of location 
NUMNUM, and 300 as arguments. Suppose that the following directive is 
executed next: 


-HYPOT #AREA,#3,,#200 


When the directive is executed, the argument block contains the value 
3, the contents of location NUMNUM, and 200. 
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Format for Calls Not Using Argument Blocks 


For those calls that do not use an argument block, Chapter 7 shows the 
format as: 


~-RTCALL argl, arg2, ..., argn 


These directives expand to code that stores the arguments, if any, in 
RO and/or the stack. (The RT11 emulator removes any values pushed on 
the stack before control returns to the user program.) 


Again, the arguments should be appropriate as operands in MOV 
instructions. You can omit certain arguments for this form; Chapter 7 
indicates these possible omissions with brackets when it describes the 
directive calls. For example, if the macro call format was as 
follows, you could leave out the last argument: 


-HYPOT argl, arg2[, arg3} 


Channel Number and Device Block Arguments 


Many RT1l directives use arguments that define a channel number and 
device block. A device block is a 4-word area containing the device 
and file specification. The following general comments apply to these 
arguments. 


Channel Number Arguments 


Like the general monitor calls, RT11 directives which handle I/0 use a 
channel number to refer to a device. Allowable RT1l1 channel numbers 
range from 0 to 15. When you open a file or device using the RT1ll 
directives .LOOKUP or .ENTER, you give a channel number in this range. 
The RTl11]1 emulator relates the number specified in the call to the 
first free RSTS/E channel number, with the following considerations: 


o The job’s terminal (RSTS/E channel 0) is never free for the 
emulator to relate to an RT1l1 channel number. In RT1ll, you 
do I/0 to the job’s terminal with specific directives, such 
as .PRINT and .GTLINE. Thus, since RSTS/E channel numbers 
range from 0 to 15 but RSTS/E channel 0 is always busy as far 
as the RT1l1l run-time system is concerned, you can open up to 
15 channels using any 15 of the 16 possible RT11 channel 
numbers (ranging from 0 to 15). 


o The RT11 emulator always attempts to allocate RT11 channel 
number 15 to RSTS/E channel 15. Channel 15 is the channel on 
which the monitor opens the user job image file when RSTS/E 
executes a .RUN directive (see Chapter 3). The run-time 
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system loads the file and begins its execution. If the 
program is overlaid, the run-time system keeps channel 15 
open. If not, the run-time loads the file and then closes 
channel 15. 


Thus, if your program is not overlaid and you open RT1l 
channel 15, the call succeeds (unless you already have 
channel 15 open). If your program is overlaid, you cannot 
open channel 15; any attempt to do so results in an error 
indicating the channel is in use. 


Other than channel 15, there is no correspondence between the RT11l 
channel number and the RSTS/E channel number. They may or may not be 
the same. 


Device Block Arguments 


Several RT1ll directives use a device and file specification. The 
argument in these cases is an address pointing to the first word of a 
4-word device block that you allocate in your program. The format of 
the device block is 12 RAD50 characters: 


Herre eee ee eee eee ee eee + 
| device and unit number | «<—(devblk) 
Herter ee te ee ee ee ee eee eee + 
| filename | 
| (2 words) | 
tren cee ee eee eee eee eee + 
| file type | 
ten eee eee ee ee ee eee eee + 


You can use any valid RSTS/E device and unit number (0-7) for the 
first word of the device block. You can also define user logical 
names up to three characters long. If you need device numbers that 
have more than one digit (for example, KB27 or TT12), you must use the 
following steps to form the algorithm: 


1. Form the RAD5O representation of unit zero of the device you 
want. For example: 


BASEKB=" RKBO 


2. Add the decimal value of the unit number wanted. For 
example, to get the proper representation of KB36: 


KBN36=BASEKB+36. 
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3. Use this value as the first word of the device block. For 
keyboards, there is no file name and type, so you can 
construct the device block as: 


DEVBLK: ~-WORD KBN36 
- WORD 0,0,0 


Note 


If you assign a logical name with the same RAD50 bit 
pattern as some device/unit-number that you 
construct, the logical name takes precedence. The 
previous example, for instance, forms the RAD50 bit 
pattern equal to the ASCII characters KCZ. Thus, if 
you assign the logical name KCZ to the line printer, 
any call referring to DEVBLK in the previous example 
would use the line printer not KB36. 


Low 512. Bytes for RT1ll Run-Time System 
Table 6-2 summarizes the locations in the low 512. bytes of virtual 


address space that the RT1l1 run-time system uses. 


Table 6-2: Locations in First 512. Bytes That RT1ll Uses 


Contains the contents of FIRQB+FQNENT at the time the 
.RUN was executed. (See the .RUN description in 
Chapter 3, and P.RUN description in Chapter 2.) 


32,35 Contains the contents of XRB+0 when the run-time 
system was entered at P.RUN (see Chapter 2). 

40,41 Contains the starting address of the job. 

42,43 Contains the initial value of the stack pointer. If 


this value is not set by the user program in an .ASECT 
or through a LINK option, the LINK linker defaults 
this word to 1000. 
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Table 6-2: Locations in First 512. Bytes That RTll Uses (Cont. ) 


+e eee ee ee eee be ee ee ee ee ee ee ee ee ee ee ee eee eee 
| Locations | Contents 

terre eee eee he me ee ee ee ee ee ee ee ee ee eee 
| | 

| 44,45 | Contains the Job Status Word (JSW). RSTS/E uses JSW as 
| | a flag word for the run-time system. Certain bits are 
| | maintained by the RT1l1 run-time system exclusively, 

| | while others can be set or cleared by the user 

| | program. The bits you can set are marked with an 

| | asterisk in the following list. Do not use currently 

| | unassigned bits for your own purposes; future RT1ll 

| | run-time system releases may use them. 

| | 

| | Bit Meaning 

| | 

| | *15 | Core common bit. If set with .ASECT, preserves 

| | | core common when the user program is executed. 

| | | 

| | *14 | Lowercase bit. When set, disables automatic 

| | | conversion of lowercase to uppercase. 

| | | 

| | *13 | Reenter bit. When set, indicates that you can 

| | | restart the program from the terminal with the 

| | | REENTER command. 

| | | 

| | *12 | Special mode TT bit. When set, indicates that 

| | | the job is in a special keyboard input mode. See 
| | | .TTYIN/.TTINR directive descriptions, Chapter 7. 
| | | 

| | 9 | Overlay bit. When set, indicates that the job 

| | | uses the LINK overlay structure. 

| | | 

| | 8 | CHAIN bit. If set, virtual addresses 500-776 are 
| | | loaded from the memory image file when the job 

| | | is started. (These words are normally used to 

| | | pass parameters between programs.) The RT11 

| | | run-time system sets the bit if you entered the 
| | | job with the RT11 .CHAIN directive. 

| | | 

| | *6 | Inhibit TT wait bit. When set, indicates that 

| | | the job can accept input from the job’s terminal 
| | | in ODT mode with .TTYIN/.TTINR; that is, one 

| | | character at a time, as you type the characters 
| | | rather than one character at a time after you 

| | | type a whole line. 

| | 

| 46,47 | Points to the first word of the RTll read/write 

| | 


scratch pad area in the user job image area. 
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Table 6-2: Locations in First 512. Bytes That RT1l Uses (Cont.) 


| | 
| Contains the high memory address. The run-time system | 
| maintains the highest virtual address the user program | 
| can use in this word. It is initially set to the | 
| address of the last word of the user program. You can | 
| change it with the .SETTOP directive (see Chapter 7) | 
| to any address up to the start of the scratch pad | 
| area. That is, the maximum value this word can be is | 
| the contents of the word at location 46,47 minus 2. | 
| | 
| 
| | 
| | 
| 
| | 
| | 
| | 


52 Contains the EMT error code. If the directive results 
in an error, the code number of the error is always 
returned in byte 52 and the carry bit is set. Always 
refer to location 52 as a byte, not a word. 
24.55 Contains the beginning address of the scratch pad 
area. 
tee eeeneeee tn ne ee ee ee ee ee ee ee ee ee eee + 


Scratch Pad Area in User Job Image 


The RT11 run-time system uses part of the user job image space as a 
scratch pad. Some of the information in this scratch pad is the same 
as the information in the RT-11 operating system, as the RT-1ll 
Programmer’s Reference Manual describes. Other information is unique 
to RSTS/E. For example, you can set a word in this area with a PPN to 
be used when opening a file. RT-11 does not allow a PPN in its file 
specification; RSTS/E does. 


In any case, the RT11 emulator adds the scratch pad area to the end 
(high virtual addresses) of the user job image at execution time. If 
you do not use RT1l1 SIZE command (see the RSTS/E System User’s Guide), 
the emulator determines the highest address of the program from the 
-SAV file, an item which the LINK linker calculates, and rounds the 
address up to the next multiple of 1024 (1K words) to determine the 
starting address of the scratch pad. If you use the RT1l SIZE 
command, the emulator places the scratch pad in the top 1K words of 
the address space that SIZE requests. 


Thus, the maximum size of MACRO programs running under the RT1ll 
run-time system is 27K words. Any program larger than this causes the 
??Maximum memory exceeded error message when the file is run. 


You can determine the start of the scratch pad area from word 54 in 
the low 512. bytes of memory. 
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Table 6-3 lists the offsets to locations in the scratch pad area that 
may be of use to you. 


Table 6-3: Offsets to Important Scratch Pad Area Locations 


tere eee ee +----+------ te ne ee ee ee ee ee eee 

| Octal | Mnemonic | 

| Offset | Offset | Contents 

tore rece torte eee eee Her ee re ee ee ee ee ee ee ee eee ee eee eee 
0 PPN If nonzero, used as a PPN for all of the calls 


named in this section except .READ and .WRITE. 
(Note that for .SETFQB, this value is loaded 
into FIRQB+FQPPN and overrides any PPN 
resulting from examination of the string by 
the corresponding .CSISPC directive.) 


For .READ and .WRITE, this word forms the 
modifier word (at XRB+XRMOD) in the 
corresponding RSTS/E .READ or .WRITE 
directive. 

PROTEC If nonzero, this word is the protection code 
to be used for all of the calls named in this 
section except .READ and .WRITE. (Note that 
for .SETFQB, this value is loaded into 
FIRQB+FQPROT and overrides any protection code 
resulting from examination of the string by 
the corresponding .CSISPC directive.) 


For .READ and .WRITE, this word forms the most 
Significant bits of the block number in the 
corresponding RSTS/E .READ or .WRITE (at 
XRB+XRBLKM). This value supplements the block 
number argument from the RTl1 .READ or .WRITE 
call. 

MODE For RT11 calls .LOOKUP, .ENTER, and .REOPEN, 
this word forms the mode word at FIRQB+FQMODE 
in the corresponding RSTS/E CALFIP call. For 
-SETFQB, this word is loaded into FIRQB+FQMODE 
and overrides any /MODE qualifier that the 
-CSISPC directive finds. 

CLUSTR For RTl1 directives that create files, such as 
-ENTER, this word forms the cluster size (at 
FIRQB+FQCLUS) for the corresponding RSTS/E 
CALFIP call. For .SETFQB, this word is loaded 
into FIRQB+FQCLUS, and overrides any 
/CLUSTERSIZE qualifier that the .CSISPC 
directive finds. 
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| Octal 


12 


66 
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Offsets to Important Scratch Pad Area Locations (Cont.) 


Mnemonic | 
Offset | Contents 


| 

POSITN | For RT11 directives that create files, such as 
| «ENTER, this word forms the device cluster 

| number for file placement (at FIRQB+FQNENT) in 
| the corresponding RSTS/E CALFIP call. For 

| .SETFQB, this word is loaded into FIRQB+FQNENT 
| and overrides any /POSITION qualifier that the 
| .CSISPC directive finds. 

| 

CRMSBS | For RT1l1 calls that preallocate space for a 

| file on its creation (.ENTER), this word forms 
| the most significant bits (MSBs) of the file 
| size (at FIRQB+FQSIZM) in the corresponding 

| CALFIP call. For .SETFQB, this byte is loaded 
| into FIRQB+FQSIZM. 

| 

NOCTLC | This word is used by the RT1ll run-time system 
| to stop user-entered CTRL/Cs from interrupting 
| program execution during certain crucial 

| sequences (.SRESET, .HRESET, .LOOKUP, .ENTER, 
| »~REOPEN, .CLOSE, and .SAVESTATUS). 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 


When set to 177777, user-entered CTRL/CS 
interrupt execution. A zero or positive value 
inhibits CTRL/C interrupts. While this word is 
zero or positive, any user-entered CTRL/C 
increments the contents of this word by one. 


When the emulator reenables CTRL/Cs, it 
processes any pending CTRL/C by either: 


o Passing control to a user routine 
specified with .SETCC (Chapter 7) 


o If no .SETCC is in effect, passing 
control to the job keyboard monitor. If 
the job keyboard monitor is RT1ll, the 
keyboard monitor commands CONTINUE or 
CCONTINUE resume execution of the program 
at the point where the interrupt 
occurred. 
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Table 6-3: Offsets to Important Scratch Pad Area Locations (Cont.) 


+-------- Se Se i i a 

| Octal | Mnemonic | 

| Offset | Offset | Contents 

t-------- toe eee eee He eee eee eee 
66 Your program can clear this word to inhibit 


CTRL/CS, process them later in whatever manner 
you see fit, and reenable CTRL/C interrupts by 
setting this word to 177777. However, note 
that the RT11 emulator clears the word and 
then reenables interrupts when .SRESET, — 
»~-HRESET, .LOOKUP, .ENTER, .REOPEN, .CLOSE, or 
-SAVESTATUS is executed. 


Emulator version number. The same as the RT-11 
operating system version number that the 
current RT11l run-time system emulates. 


Emulator release number. The same as the RT-11 
operating system release number that the 
current RT1ll run-time system emulates. 


Configuration word. Set for RSTS/E 
environment, as follows: 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| If FPl1l floating-point hardware exists, 
| bit 6 is set to one. Bit 9 is always set 
| to one, and all other bits are set to 
| zero. 

| 
| 
| 
| 
| 
| 
| 
| 
: 
| 
| 
: 
| 
| 
| 
| 


(If your program tests these bits on an 
RT-11 system, the code also works on 
RSTS/E. ) 


Extension configuration word. Under RSTS/E, 
bits 0-3 are always zero, bit 8 is always one 
(indicating the EIS option is present), and 
bits 9, 14, and 15 are always zero. (The 
conditions they indicate on RT-11 systems are 
not determinable by the RT1l run-time system 
under RSTS/E. ) 


SYSGEN options word. This word is always zero 
on RSTS/E systems. 


User job image size. This word is always zero 


| 
| 
| 
| 
| 
| 
: 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
: 
| 
| 
| 
| 
| 
| on RSTS/E systems. 


RT1l1 Run-Time System Environment 


The first six words in the scratch pad are of special significance; 
the following general comments apply: 


oO 


The directives .LOOKUP, .ENTER, .RENAME, .REOPEN, .DELETE, 
and .SETFQB examine the first six words, use any values there 
as described, and clear the first six words before returning 
control to the user program. 


The directives .READ and .WRITE examine, use, and clear only 
the first two words. 


The .CSIGEN directive clears the first six words before 
performing any of the .LOOKUP and .ENTER calls resulting from 
its examination of the command string. 


Chapter 7: RTl1 Emulator Directives 


RSTS/E does not emulate some of the RT-11 operating system’s 
Single-job monitor calls. RSTS/E ignores the following: .CMKT, 
»~-HERR, .LOCK, .QSET, .MRKT, .RELEASE, .SERR, and .UNLOCK. The .CDFN 
call always returns an error 0 on RSTS/E systems. The following 
Single-job monitor calls are not expanded to include EMTs, and their 
results on RSTS/E systems are unpredictable: .INTEN, .MFPS, .MTPS, 
and .SYNCH. 


The RT-11 foreground/background (FB) and extended monitor (XM) calls 
are not supported; they are essentially ignored on RSTS/E systems. 
They do not return errors. 

Table 7-1 lists the directives that are not processed by the RT11l 
run-time system on RSTS/E systems. 


Table 7-l: RT-11 Calls Not Functional on RSTS/E 


All FB calls 


terre eee eee eee 0 ee toner ete ee eee eee + 
| | Return | | 
| Ignored | Error 0 | Unpredictable | 
Sn tern eee rere | + 
| | | | 
| .CMKT | .CDFN | . INTEN | 
| | | | 
| . HERR | | .MFPS 
| | | | 
| . LOCK | | -MTPS | 
| | | | 
| .QSET | | . SYNCH 
| | | | 
| .MRKT | | 
| | | | 
| . RELEASE | | | 
| | | | 
| . SERR | | 
| | | | 
| . UNLOCK | | 
| | | | 
| | | | 
| | | | 
| | | | 


Table 7-2 lists the directives that are processed by the RT11 run-time 
system on RSTS/E systems. 


RT11 Emulator Directives 


Table 7-2: 


- READ 
- READW 
- READC 


- REOPEN 


- SAVESTATUS 


- RENAME 


RT11 Run-Time System Directives 


|Function | 
| EMT | 


Code 


| Description 


|Lets you assemble directives as they 
{would be expanded under Version 1 or 
|Version 2 of RT-1ll. 


{Transfers data from a memory buffer to 
|a file or device on an open channel. 
|As with the .READ/W/C directives, 

| .WRITE and .WRITEW operate identically 
|on RSTS/E; .WRITC transfers control to 
{a completion routine after the 
|transfer is complete. 

| 

|Transfers data from a file or device 
|on an open channel to a memory buffer. 
|I/O is synchronous under RT1l 
|emulation on RSTS/E systems, so for 
{all three reads, control returns to 
|the user program only when the 
|transfer is complete. .READ and .READW 
|are identical on RSTS/E systems. 
|.READC transfers control to a 
|user-specified completion routine when 
|the transfer is complete. 

| 

{Opens a file closed with .SAVESTATUS. 
|Using the .SAVESTATUS/.REOPEN 
|combination is easier than using 
|standard opens and closes; the device, 
|file name and type, and 
|project-programmer number are saved 
{automatically with .SAVESTATUS. You 
|only need to keep track of the address 
|in which you stored the file 
|information to reopen it. 

| 

|Closes a file, keeping the information 
|needed to .REOPEN the file later. 

| 

|Changes a file’s name on disk or 
|DECtape. 


RT11 Emulator Directives 


Table 7-2: RT1l1 Run-Time System Directives (Cont. ) 


re ee Se ios + 
| | |Function | | 
| Mnemonic |EMT| Code _ | Description | 
en er ee eee ee eee eee + 
| Input/Output and File Operations (Cont.) | 
ene een ee eee eee +---+-------- ten ee ee ee ee ee eee eee eee + 
| | | 
. ENTER | 375] 2 |Creates a file and opens it ona 
| | |channel. 
| 
. LOOKUP 375 1 |Opens an already existing file ona 


|channel. .LOOKUP can also be used for 
|non-file-structured I/O operations. 


| 
0 {Deletes a disk or DECtape file. 


| 
6 |Terminates I/O operations ona 
|channel, performing clean-up 
|operations (positioning tape, and so 
|forth) and releasing the channel for 
|other use. 

| 
3 |Releases a channel without performing 
|the normal clean-up operations. In 
|particular, a file opened with .ENTER 


| 

| 

| 

| 

| 

| 

| 

| 

- DELETE | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
land not yet closed is not made a | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


- CLOSE 


- PURGE 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| {permanent file. 

| | 

| -- |Closes all open channels, without 

| |performing normal clean-up operations. 
| |In particular, files opened with 

| |. ENTER and not yet closed are not made 
| |permanent. 

| | 
| -- |Functions the same as .HRESET on 
| |RSTS/E. 

| | 
| -- |Displays an ASCII string on the job’s 
| |terminal. 

| | 
| -- [Accepts a line of input from the job’s 
| |terminal. 

| | 
| -- |Transfers one character from RO to the 
| |job’s terminal. 

| | 
| -- |Transfers one character from the job’s 
| |terminal to RQ. 


- SRESET 
-PRINT 
-GTLIN 


- TTYOUT 
-TTOUTR 


- TTYIN 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
.HRESET | 357 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
.TTINR | 


Tll Emulator Directives 


‘lable 7-2: RT1l1 Run-Time System Directives (Cont. ) 


|from the job’s terminal) for a 
|standard RT1l1 command, and sets up 
|device blocks for later opens. 


ee ee eee eee oo ee i ie ie i 
| |Function | 
Mnemonic |EMT| Code | Description 
See ee ee eee So i i i i ee 
Special Functions Related to I/0 
tee ee ee ee ee eee Se i 
| | | 
. SPFUN |375| 32 |Performs special functions for disk, 
| | |terminal, magnetic tape, and flexible 
| | |diskette. 
| | | 
~SCCA | 374 | 35 |Causes a CTRL/Z entered by the user to 
| | |be passed on to the user program. 
| | | 
-WAIT | 374 | 0 |Checks to see if channel is open. 
| | | 
. CLRXRB 1371 | -- |Clears the XRB (see Chapter 2). 
(RSTS/E only) | | | 
| | | 
-CLRFQB |370| -- |Clears the FIRQB (see Chapter 2). 
(RSTS/E only) | | | 
| | | 
-DOFSS |365| -- |Analyzes an ASCII string in memory for 
(RSTS/E only) | | |a RSTS/E file name and returns 
| | |information as for .FSS (general 
| | |monitor directive). Use instead of 
| | |.FSS for programs running under RT1ll 
| | |run-time system. 
| | | 
- ERRPRT | 364 | -- |Prints text corresponding to RSTS/E 
(RSTS/E only) | | {error code on the job’s terminal. 
| | | 
-SETCC | 362 | -- |Defines an entry point for CTRL/C 
(RSTS/E only) | | |traps; allows the user program to 
| | lhandle its own CTRL/Cs. 
| | | 
. SETFQB | 360 | -- |Sets the FIRQB (see Chapter 2) from 
(RSTS/E only) | | |information returned by the .CSISPC 
| | |directive. 
| | | 
.RCTRLO | 355 | -- |Restarts programmed output to job’s 
| | {terminal that was stopped by 
| | |user-entered CTRL/C or CTRL/O. 
| | | 
-CSISPC |345| -- |Analyzes an ASCII string (in memory or 
| | 
| | 
| | 


RT11 Emulator Directives 


Table 7-2: RT1l11 Run-Time System Directives (Cont. ) 


5 Se pr e ee  e  e e ee e e eeeeee + 
| | |Function | | 
| Mnemonic |EMT| Code | Description | 
re ee ee eee eee + 
| Special Functions Related to I/0 (Cont.) | 
Hence eee ee eee So Hen ee ee ee ee ee eee ee eee + 
| | 
. CSIGEN 344 -- {Analyzes an ASCII string (in memory or 


|from the job’s terminal) for a 
|standard RT11 command, and opens files 


(RSTS/E only) |internal format to ASCII string. 


| 

-- |Sets location 40 (indicating top of 
luser job image area) to the address 
|specified. 


-SETTOP 


| | 
| | | | 
| | | | 
| | | | 
| | | |accordingly. | 
| | | | | 
| . FETCH | 343 | -- |Checks to see if device is available | 
| | | lon the system. | 
| | | | | 
| .»~DSTATUS 1342 | -- |Returns information about a device to | 
| | | jan area in the user program. | 
tee eee ete ee ee eee i Hee ee ee ee ee ee ee ee eee + 
| System/Job Information | 
tere ete eee ee eee a ee Si i + 
| | | | | 
| .GVAL |375| 34 {Returns the contents of a word in the | 
| | | {scratch pad area. | 
| | | | | 
| .GTIM 1375 | 21 {Returns the time of day. | 
| | | | | 
| .GTJB |375| 20 |Returns the current job number. | 
| | | | | 
| .DATE | 374 | 12 {Returns the current date. | 
| | | | | 
| .~DATTIM | 361 | -- |Converts date or time from RSTS/E | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 


.SFPA |375| 30 |Sets address to be entered for 
| | | floating point errors. 

| 

4 |Timed wait. Suspends job execution for 


| 

| 

| 

| 

- TWAIT | 
|specified number of clock ticks. | 
| 

| 

| 

| 

| 


| | 
| | 
| | 
| | | 
-TRPSET |375| 3 |Sets address to be entered for 
| | 
| | 
| | 


|reserved instruction and odd address 
|errors; normally trapped to kernel 
|mode addresses 4 and 10. 


7-5 


RT11 Emulator Directives 


Table 7-2: RT1ll Run-Time System Directives (Cont. ) 


t---- eee eee eee toc eter eee ten ee eee eee + 
| | |Function | | 
| Mnemonic |EMT| Code | Description | 
pr eee eee + 
| Execution Control (Cont. ) | 
tee - eee eee eee eee +--+t+---- eee Hr ee ee eee eee + 
| | 
. CHAIN 374 10 |Transfers control to another program 


|(file) to be run under the RT1ll | 
|run-time system. | 

| | 

-- |Examines a string for valid RSTS/E CCL | 
|command. If valid, transfers control | 

|to new program. Use instead of .CCL | 
|(general monitor directive) for | 
|programs running under RT1ll run-time | 
|system. | 

| | 

-- |Expands size of user job image. Use | 
|when .CHAIN is used to transfer | 
|control to a program larger than the | 
|current program. In addition, use | 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 


| 
| 
| 
| 
-DOCCL | 
| 
| 
| 
| 
| 
| 
| 
| 
| |instead of .CORE (general monitor 
| 
| 
| 
| 
| 
| 
| 
: 
| 
| 
| 
| 
| 
| 


(RSTS/E only) 


.GETCOR 
(RSTS/E only) 


|directive) for programs running under 
|RT11 run-time system. 
| 
-- |Transfers control to another program 
|(file) that runs under a non-RTll 
|run-time system. Use instead of .RUN 
|(general monitor directive) for 
|programs running under RT1l1l run-time 
|system. 
| 
-- |Terminates execution of the calling 
|job. Note that you should not use the 
|RSTS/E .RTS or .EXIT directives from a 
|program running under the RT1l 
|run-time system. 


» DORUN 
(RSTS/E only) 


-EXIT 


The remaining sections of this chapter describe the directives in 
detail, in alphabetical order. Note that for all calls, you need only 
specify the first six characters. For example, the abbreviation 
-SAVES works as well as .SAVESTATUS. 


All the examples in this chapter show Version 2 expansions. Note that 
Version 1 expansions require different arguments in the calls. See 
RT-11 system documentation if you need to use Version 1 expansions. 


- CHAIN 


CHAIN - Pass Control to Another Program Under RT11l 


The .CHAIN directive transfers control to another program without 
altering the run-time system. The .CHAIN leaves I/O channels from the 
old program still open for the new program. Thus, you can get around 
the 27K word limit for programs to be run under the RT11 run-time 
system. If the program you are chaining to takes more space than the 
current program, use the .GETCOR directive to expand the space 
allocated for the user job image area before executing the .CHAIN. 


Virtual addresses 500-507 are expected to contain the device and file 
name of the program to chain to, in the RT1l1 device block format (see 
Chapter 6). The area from locations 510-777 can be used to pass 
information between the chained programs. Make sure, though, that the 
program you are chaining to does not inadvertently destroy the data in 
locations 510-777 by pushing data on the stack. Note that the linker 
defaults the initial stack setting to 1000. 


An executing program can tell whether it was chained to or run by some 
other means by examining bit 8 of the Job Status Word (JSW) (see 
Chapter 6). If bit 8 = 1, the program was invoked with .CHAIN, and 
locations 500-777 are preserved from the program that issued the 
-CHAIN. If bit 8 = 0, the program was not entered with an RT11 
~CHAIN. 


The .CHAIN directive works only for RT11-to-RTll transfers. If you 
want to chain to a program to be run under some run-time system other 
than RT11, use the .DORUN directive (see Chapter 6). (The description 
of .DORUN also describes what happens for RT11l programs receiving 
control from non-RTll programs. ) 
Privileges Required 
Read or execute access to the file. 
Macro Call 

. CHAIN 


Request Format 


- CHAIN 


Errors 


Since .CHAIN is intended to pass control to another program, no errors 
are returned to the calling program. If the new program cannot be 
chained to, the .CHAIN is abandoned, and the keyboard monitor is 
entered. (Control passes to the P.NEW entry point of the RT1l 
run-time system, which is the keyboard monitor’s entry point for 
RT11.) 


Example 


The following code requests an expansion to 20K words and chains to a 
sample file named MYFILE.SAV in the user’s account: 


FILE: -RAD50 /MYFILESAV/ ;Define text passed in chain 
MOV #20.,R0 sIndicate 20.K now needed 
-GETCOR 
CLR 500 ;Default for the device 
MOV #FILE,502 :Move 
MOV #FILE+2,504 ; the 
MOV #FILE+4,506 : file name 
. CHAIN ;Invoke the new program 


- CLOSE 


-CLOSE - Close a Channel 


Use the .CLOSE directive to terminate I/O on a particular channel. 
The .CLOSE directive: 


o Performs whatever action is appropriate to the device (such 
as updating a disk directory to indicate a new file, 
repositioning a magnetic tape, and so forth) 

o Frees the RT11 channel number for use with another device 

o Frees the RSTS/E channel from its association with the RTll 
channel number (effectively making another channel 
available). 

A .CLOSE on a file opened with .ENTER makes the file permanent; the 
file is tentative until that time. Note that, unlike the RT-11 
operating system, RSTS/E does not deallocate unused space. Thus, if 
you preallocated space when you opened the file with .ENTER, the file 
contains all this space after the .CLOSE. 
Privileges Required 
None 
Macro Call 

-CLOSE chanum 


where: 


Chanum is a channel number in the range 0 to 17 (octal). See 
Chapter 6 for rules on channel numbers. 


RO Format 


Errors 


No errors are possible with the .CLOSE directive. RSTS/E ignores a 
-CLOSE for a channel that is not currently open. 


Example 
The following statement closes channel 5: 


-CLOSE #5 


- CLRFQB 
(RSTS/E Only) 
-CLRFQB - Clear the FIRQB 
This directive clears the FIRQB area in the low 512. bytes of virtual 
memory (see Chapter 2). No data is passed or returned for this 
directive. 
Privileges Required 
None 
Macro Call 

. CLRFQB 
Note that .CLRFQB, like all RSTS/E-specific directives under RTll, is 
not expanded at assembly time. (It is not defined in the SYSMAC.SML 
file as a directive.) You can code a definition of the directive ina 
data section of your program or use .MACRO to define it. See the 
following example. 
Errors 
No errors are possible with the .CLRFQB directive. 


Example 


The following example clears the FIRQB area in the low 512. bytes of 
virtual memory: 


.CLRFQB = EMT+370 


- CLRFQB 


- CLRXRB 
(RSTS/E Only) 
-CLRXRB - Clear the XRB 


This directive clears the XRB area in the low 512. bytes of virtual 
memory (see Chapter 2). No data is passed or returned with .CLRXRB. 


Privileges Required 
None 
Macro Call 

- CLRXRB 
Note that .CLRXRB, like all RSTS/E-specific directives under RT1ll, is 
not expanded at assembly time. (It is not defined in the SYSMAC.SML 
file as a directive.) You can code a definition of the directive ina 
data section of your program or use .MACRO to define it. See the 
following example. 
Errors 
No errors are possible with the .CLRXRB directive. 


Example 


The following example clears the XRB area in the low 512. bytes of 
virtual memory: 


-CLRXRB = EMT+371 


- CLRXRB 


- CSIGEN 


~CSIGEN - Examine String for RT Command, Open Files 


The .CSIGEN directive examines a string (either in memory or from the 
job’s keyboard) to process a standard RT11 command string. If the 
string is to be accepted from the job’s keyboard, the .CSIGEN first 
prints an asterisk (*) prompt on the keyboard and then waits for you 
to type a line. 


If the string is in the correct form, any files or devices open on 
RT11 channels 0 - 10 (octal) are closed and then either reopened or 
left inactive, depending on whether or not a file is given for that 
slot. For example: 


objfile,listfile,crefile=srcfilel,srcfile2,...srcfile6 
channel 0 1 2 3 4 10 


Any valid RSTS/E file specification can appear in the string, 
including file specifications with PPNs, and logical names. However, 
the file specifications cannot contain wildcards. Files on the left 
side of the equal sign are opened with .ENTER, and the files on the 
right side of the equal sign are opened with .LOOKUP. If the equal 
sign is missing, RSTS/E assumes an equal sign at the beginning of the 
string. For example, consider the string: 


NOW.OBJ ,NOW.LST,NOW. CRF=THEN.MAC 
The file NOW.OBJ would be opened with .ENTER on channel 0; NOW.LST, on 
channel 1; NOW.CRF, on channel 2. The file THEN.MAC would be opened 
with .LOOKUP on channel 3. Two more examples are: 


NOW.OBJ, ,NOW.CRF= 


The file NOW.OBJ would be opened with .ENTER on channel 0 and NOW.CRF 
on channel 2. Channels 1 and 3-10 would be inactive. 


LP: 
The line printer would be opened with .LOOKUP on channel 3. 
RSTS/E Options 
The file specifications can include any of the standard RSTS/E 
qualifiers processed by the monitor itself (see the .FSS directive, 
Chapter 3). These include: /CLUSTERSIZE, /RONLY, /MODE, /PROTECTION, 


/FILESIZE or /SIZE, and /POSITION. The RTl1 Emulator can handle any 
of these optional qualifiers that .CSIGEN finds in the command string. 


-CSIGEN 


RT11 Options 


The .CSIGEN directive under RSTS/E also does RTll-type analysis of 
options. One or more options can appear after any of the file 
specifications. The general form of an option is: 


The slash (/) indicates an option; it must be followed by a 
one-character option code. (The character does not have to be 
printable.) The slash-character pair can be followed by one or more 
values. A colon (:) indicates that a value follows. If given, the 
colon must be followed by: 


Oo An octal number in the range 0 to 177777. 


o A decimal integer in the range -32768. to 32767. (the 
terminating period must appear). 


o From one to three alphanumeric characters, with the first 
character alphabetic. 


The .CSIGEN directive examines any options in the string to ensure 
that they are in the correct form, reformats them, and pushes them on 
the stack for the user program to examine. The information pushed on 
the stack is ordered by channel; if an option is given for the file 
specification for channel 0 (assuming there is a file specification in 
the first slot), it is pushed on the stack first, followed by option 
information for the file specification for channel 1 (if any), and so 
forth. The last word pushed on the stack is an integer value 
indicating the total number of options in the string. An option 
having two values is formatted as two options. The format is: 


tne nce ee ee ee eee terre ee ee ee eee eee eee + 
| number of options in string | 
Henne ee ee ee ee ee eee eee eee Sr + 
| value-flag/channel | option code (ASCII) | 
tee e eee eee wee eee ee eee tener eee eee ee eee ee eee eee + 
| value (integer or RAD50) or next option | 
tener eee eee eee eee ee ee eee Herren eee eee eee eee eee + 
| | 
| | 
| . | 
Sr ten eee re eee ee ee eee eee + 


Bit 15 of a value-flag/channel byte is set to one if the option had an 
associated value, to zero if it did not. Thus, if bit 15 is set, the 
next word is the value associated with the option. (The option code 
itself is in the low byte of this word.) If bit 15 is zero, the next 
word is the next option (if any). Bits 8 to 14 of a 
value-flag/channel byte indicate the RT1l1 channel number with which 
the file specification having the option is associated. 


e138 


- CSIGEN 


Privileges Required 


Read or write access to the files specified. DEVICE privilege is 
required to access a restricted device. 


Macro Call 


-CSIGEN devspc,defext,[cstrng][,linbuf ] 


where: 
devspc 


defext 


cstrng 


linbuf 


is ignored on RSTS/E systems. 


is the address of a four-word area containing default file 
types, in RAD5O format. The format of the area is: 


| debeult,or files, open son channel: 3-10) 
[) @eeaule tor-€ie- open en cnankel,0. | 
| Mersiie for cite open-cn euaanen 1 | 
| default for file open on channel 2 | 
Herne ee ee eee ee eee ee eee + 


These values are then used when no corresponding file type 
is given in the examined string. For example, in the MACRO 
assembler, the first word would contain MAC in RAD50 format; 
the second, OBJ; the third, LST; and the fourth, CRF. 


is the address of the ASCIZ string to be examined or a #0 if 
input is to come from the job’s terminal. If this argument 
is not specified, input is automatically taken from the 
job’s terminal. 


is the address where the original string (if accepted from 
the job’s terminal) is to be stored. This area should be 
81. bytes long. The string will be terminated with a zero 
byte, instead of a carriage-return/line-feed combination. 


If this argument is omitted, the original string is not 
kept. 


- CSIGEN 


Errors 


If an error occurs when input is accepted from the job’s terminal, the 
user gets another try. An error message is printed on the terminal, 
along with another * prompt, and the directive waits for you to type 
another line. 


If the string being examined is in memory and an error occurs, the 
carry bit is set, and one of the following error codes is returned in 
byte 52. The options and option-count are removed from the stack. 


Code Meaning 


0 Illegal command (bad separators, illegal file name, command too 
long, and so forth). 


1 A device specification was not recognizable or the device is not 
available on the systen. 


2 Unused. 

3 An attempt to open a file with .ENTER failed because of a full 
directory. 

4 An input file (to the right of the equal sign) was not found in 
a .LOOKUP. 

Example 


The following example includes option switches and shows more clearly 
how options and values are pushed on the stack: 


DEFEXT: .RAD50 /MACOP1OP20P3/ 


. CSIGEN #0,#DEFEXT, #0 
Assume that the line typed at the job’s terminal is: 
OUTFIL/M: 32.,,ODDFIL=[2,200]HISFIL,DTO:HERFIL/G:NRD: 20 


When control returns to the user program following the .CSIGEN, the 
file OUTFIL.OP1 on the public structure has been opened with the 
-ENTER directive on channel 0, and the file ODDFIL.OP3 on channel 3. 
The file HISFIL.MAC on the public structure, under account [2,200], 
has been opened with the .LOOKUP directive. (If the calling job did 
not have the necessary privilege, an error message would have been 
displayed on the terminal, and another line accepted.) The file 
HERFIL.MAC on DECtape unit 0 has also been opened with .LOOKUP. 


- CSIGEN 


The stack contains: 


(SP) 


Word 


— i 


Octal 


Value 


3 


102107 


000020 


102107 


055124 


100115 


000040 


Explanation 


Three options were found in the string. 
(The G option has two values.) 


Last option has a value, and the option is 
associated with channel 4. The option code 
is G. 

The value of the option is 20 (octal). 
Next-to-last option has a value, and the 
option is associated with channel 4. The 
option code is G. 

Value of option is NRD in RAD50 format. 

The first option has a value, and the option 
is associated with channel 0. The option 


code is M. 


The value of the option is 40 (octal). 


~CSISPC 


»CSISPC - Examine String for RT Command, Create Devblk 


Like .CSIGEN, the .CSISPC directive parses a string (either in memory 
or from the job’s terminal) to see if it is a valid RTll-type command 
String. If the string is to be accepted from the job’s terminal, 
»CSISPC first displays an * prompt on the screen and then waits for 
you to type a line. Instead of closing and opening files, however, 
»CSISPC simply returns a 39-word block of information about the files 
named in the string. The user program can later use this information 
to open the files. See the previous discussion of .CSIGEN for command 
string format and option processing. 


Note that .CSISPC, like .CSIGEN, stores RSTS/E-specific file 
information (PPN, and so on) within the scratch pad area. 
Furthermore, you can issue a .SAVESTATUS or .SETFQB referencing the 
device-block information returned by .CSISPC (although .SAVESTATUS 
works only for input files to the right of the equal sign when opened 
with .LOOKUP). 


If you use .CSISPC in this way, be sure that you reference addresses 
in the outspec area returned by .CSISPC. If you move the information 
in the outspec area and then refer to the new area in .SAVESTATUS or 
-SETFQB, the RSTS/E-specific information, such as PPN, is not used. 
(The emulator keeps a pointer in the impure area relating the PPN and 
other RSTS/E-specific information to the area returned by .CSISPC.) 


Privileges Required 
None 
Macro Call 
-CSISPC outspc,defext,cstrng[,linbuf } 
where: 
outspc is the address of a 39-word area to contain the file 
descriptors produced by .CSISPC. This area can overlay the 


space allocated to cstrng, if desired. The format of the 
information returned is: 


eCSISPC 


+-------- tere ee ee eee eee + toc c cere 5 + 
| Offset | Contents | | Offset | Contents | 
+-------- torre eee eee eee + 5 + 
| 0 | | | 46 | | 
| | | | | | 
| | devblk for | | | devblk for | 
| | | | | | 
| | channel 0 | | | channel 4 | 
| | | | | | 
| 6 | | | 54 | | 
+----+---- tere eee ee ee eee + i + 
| 10 | size | | 56 | | 
+-------- 2 + | | | 
| 12 | | | | devblk for | 
| | | | | | 
| | devblk for | | channel 5 | 
| | | | | 
| | channel l_ | | 64 | | 
| | | ee + 
| 20 | | | 66 | | 
torre eee 5 + | | 
| 22 | size | | devblk for | 
t-------- t---- eee ee eee + | | | 
| 24 | | | | channel 6 | 
| | | | | | 
| | devblk for | 74 | | 
| | | te eeeeeee bocce eee eens + 
| | channel 2 | | 76 | | 
| | | | | | 
| 32 | | | | devblk for | 
+-------- tee ee eee eee ee + | | | 
| 34 | size | | | channel 7 | 
+t-------- t--- errr ee eee + | | 
| 36 | | | 104 | | 
| | | eis <a ae Hosen teres eens + 
| | devblk for | | 106 | | 
| | | | | 
| | channel 3 | | | devblk for | 
| | | | | | 
| 44 | | | | channel 10 | 
+-------- toe cere eee eee + | | | 

| 114 | | 

tee cere ee terre eee eee + 


Information for the files for channels 0, 1, and 2 is stored 
in 5-word blocks. The first four words are RAD50 
information in the standard RT11 device block format (see 
Chapter 6). The last word is the file size indicated by a 
/FILESIZE or /SIZE option, if any was encountered for these 
files in the string. Since files on the left side of the 
equal sign are opened with .ENTER, they can have a size for 
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-CSISPC 


preallocation. Information for the files for channels 3 to 
10 is stored in 4-word blocks, in the standard RTll device 
block format. If any files are omitted in the string, the 
corresponding 4- or 5-word block is filled with zeros. 


defext is the address of a four-word block containing the RAD50 
default file types. (See the discussion of .CSIGEN for the 
format of this area.) These defaults are returned to the 
outspec area if no types are given in the examined string. 


cstrng is the address of the ASCIZ string to be examined or a #0 if 
input is to come from the job’s terminal. If this argument 
is not specified, input is automatically taken for the job’s 
terminal. The string must follow the rules for an RT1ll 
command string, as described for .CSIGEN. 


linbuf is the address where the original string (if accepted from 
the job’s terminal) is to be stored. This area should be at 
least 81 bytes long. The string is terminated with a zero 
byte instead of a carriage-return/line-feed combination. 


If this argument is omitted, the original string is not 
kept. 


Errors 


If an error occurs when input is accepted from the job’s terminal, the 
user gets another try. An error message is printed on the terminal, 
along with another * prompt, and the directive waits for you to type 
another line. 


If the string being examined is in memory and an error occurs, the 
carry bit is set, and one of the following error codes is returned in 
byte 52. The options and option-count are pushed from the stack. 


Code Meaning 


0 Illegal command line (bad separators, illegal file name, command 
too long, and so forth). 


1 A device specification was not recognizable or is not available 
on the system. 


-CSISPC 


Example 


The following code accepts a line of input from the terminal, checks 
it for RT1ll command format, and stores the resulting device block 
information in a 39-word area called OUTSPC: 


DEFEXT: .WORD 0,0,0,0 ;No default file types 
OUTSPC: .BLKW 39. ;Device block area 


~-CSISPC #OUTSPC, #DEFEXT, #0 


- DATE 


-DATE - Return Current Date to RO 


The .DATE directive returns the current month, day, and year to RO in 
the following format: 


The year value in bits 4-0 is the current year minus 72. 

Note that this directive gets its date information from the RSTS/E 
clock. Unlike the RT-11 operating system, you do not set the values 
returned with the DATE keyboard monitor command. 

Privileges Required 


None 


Macro Call 


-DATE 
RO Format 
tee - eee ee eee Feo e ee ee eee + 
(RO) = | 12 | 0 | 
+e reer eee eee bee ce eee eee + 
Errors 


No errors are returned with the .DATE directive. 


-DATE 


Example 


The following subroutine can be assembled separately and linked to 
user program: 


-TITLE DATE.MAC 
CALLING SEQUENCE: 
JSR PC,DATE 


INPUT: NONE 


Be eT eT eT eT eT eT aT 


OUTPUT: RO = DAY (1-31) 
Rl = MONTH (1-12) 
R2 = YEAR - 72 
-MCALL . DATE 
DATE:: .DATE ;Get the system date 
MOV RO,R2 ;Copy the date 
BIC #°C37,R2 
ASR RO 7;Put month on a byte boundary 
ASR RO ; 
MOV RO,R1 ;Copy the date 
SWAB Rl ;Put month in the low byte 
BIC #°C37,R1 s;Isolate the month 
ASR RO ;Shift day to a byte boundary 
ASR RO ’ 
ASR RO : 
BIC #° C37,R0 ;Isolate the day 
CLC ;Indicate no error 
RTS PC 
. END 


.DATTIM 
(RSTS/E Only) 


~-DATTIM - Return Date or Time 


The .DATTIM directive is available only to RT1l1 emulator users under 
RSTS/E; it is not available under the RT-11 operating system. .DATTIM 
converts a date or time from the RSTS/E system internal format (as 
returned by the .DATE directive, see Chapter 3) to an ASCII string 
Suitable for printing. The format of the string is the same as that 
returned by the BASIC-PLUS DATES and TIMES functions. That is, a date 
is in the form "27-Jun-84"; or, if the system uses the numeric date 
option, in the form "84.06.27". Similarly, a time is in the form 
"02:30 PM" or "14:30". 


The .DATTIM directive assumes that RO contains the address of the area 
to which the string is to be returned. It also expects to find the 
date or time in RSTS/E system internal format in the XRB. If a date 
is desired, it should be in XRB+0. If a time is desired, the word at 
XRB+0 should be cleared and the time stored in XRB+2. Note that these 
are the locations returned by the RSTS/E .DATE directive. 


You can request a specific format for date or time rather than 
accepting the format selected at system generation. If you set bit 15 
of XRB+0 (date) or XRB+2 (time), you request a specific format rather 
than the default selected at system generation. Bit 15 = 0 indicates 
the default. If bit 15 = 1, then bit 14 = 0 implies numeric format; 
bit 14 = 1 indicates alphanumeric format. 


Upon return from the call, RO contains the address of the first byte 
after the time or date string. 


Privileges Required 
None 
Macro Call 

-DATTIM 
Note that .DATTIM, like all RSTS/E-specific directives under RTll, is 
not expanded at assembly time. (It is not defined in the SYSMAC.SML 
file as a directive.) You can code a definition of the directive ina 
data section of your program or use .MACRO to define it. See the 
following example. 


ELrocs 


No errors are possible with the .DATTIM directive. 


.DATTIM 
(RSTS/E Only) 


Example 
The following program prints the current date and time at the job’s 


terminal: 


-MCALL -EXIT,.PRINT 
~PRIV = EMT+377 
~-DATTIM = EMT+361 


;Prefix EMT to RSTS/E 
;Date/time EMT to RT1ll 


-CSECT 
START: -PRIV, .DATE ;Get date from RSTS/E 
MOV XRB+2,-(SP) ;Save time 
MOV DATES , RO ;Set addr for ret. string 
-DATTIM ;Get date string 
CLRB (RO)+ ;Clear last byte for ASCIZ 
- PRINT #DATMSG ;Print date message 
CLR XRB s;Clear date from XRB 
MOV (SP)+,XRB+2 ;Set time in XRB 
MOV TIMES ,RO ;Set addr for time string 
.DATTIM ;Get time string 
CLRB (RO)+ ;Make string ASCIZ 
. PRINT #TIMMSG ;Print time message 
-EXIT ;End program 
DATMSG: .ASCII /The date is / 
DATES: - BLKW 12 
TIMMSG: .ASCII /The time is / 
TIMES: - BLKW 12 
- END START 


- DELETE 


-DELETE -- Delete File from Disk or DECtape 

The .DELETE directive deletes a file from a disk or DECtape, deleting 
it from the device directory and releasing the space for other use. 
The file description given in the call includes a device, file name, 
and type. Set the PPN offset to include a PPN for the file, if 
desired (see Chapter 6). Otherwise, the PPN of the calling job is 
used. 


Note that on RSTS/E systems, unlike the RT-11 operating system, it is 
possible to delete files which are open; no error is returned. 


Privileges Required 


Write access to the file being deleted (if disk). DEVICE privilege is 
required if the device is restricted. 


Macro Call 
.DELETE area,chanum,devblk,seqnum 
where: 
area is the address of a three-word argument block. 
chanum is ignored on RSTS/E systems. 
devblk is the address of a four-word device block containing the 
device and file specification. See Chapter 6 for the format 
of this area. See also the PPN offset description for 
specifying a PPN. 


seqnum is ignored on RSTS/E systems. 


Argument Block Format 


tore tee eee porter ee + 
| 0 | chanum | € (RO) 

tore reer eee | eS + 

| devblk | 

torr cree eee terre cere eee + 

| seqnum | 

toe rere eee toe c ere eee + 

Errors 

Code Meaning 

a The file named cannot be found. 

2 The device specified is not a disk or DECtape. 
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- DELETE 


Example 


The following code deletes the file name FILNAM.TYP in the user’s 
account on disk unit 1: 


AREA: - BLKW 3 
DEVBLK: .RAD50 /DK1FILNAMTYP/ 


. DELETE #AREA,#1,#DEVBLK 


-DOCCL 
(RSTS/E Only) 
-DOCCL ~- Do a RSTS/E .CCL 
This directive lets a program running under control of the RT11 
run-time system examine a string to see if it is a valid RSTS/E 
Concise Command Language (CCL) command. 
Note 
-DOCCL must be used by programs running under the 
RT11 run-time system, rather than the general monitor 
.CCL command. 
If the string is a valid CCL command, the RT1l1 run-time system 
restores the low 512. bytes of memory to what the monitor expects and 
issues a general monitor .CCL command. (See Chapter 3 fora 
description of .CCL.) 
The starting address of the string to be examined is passed in RO. 
The string itself must be in ASCIZ format (terminated with a zero 
byte). 
Privileges Required 
Execute access to the program that the CCL command executes. 
Macro Call 
-DOCCL 
Note that .DOCCL, like all RSTS/E-specific directives under RT1l, is 
not expanded at assembly time. (It is not defined in the SYSMAC.SML 
file as a directive.) You can code a definition of the directive ina 
data section of your program or use .MACRO to define it. See the 
following example. 


Errors 


The errors returned for .DOCCL are the same (and in the same format) 
as for .CCL. 


Example 
The following code executes the CCL command PIP: 


-DOCCL = EMT+367 


STG: ~-ASCIZ /PIP/ 
MOV #STG,RO 
-DOCCL 


-DOFSS 

(RSTS/E Only) 

-DOFSS ~- Do a RSTS/E .FSS 

The .DOFSS directive examines a string to see if it is a valid RSTS/E 
file specification. The RT1l emulator restores the low 512. bytes of 
memory to what the monitor expects and executes a .FSS directive. 


Note 


You must use .DOFSS rather than .FSS for a program 
running under the RTll run-time system. 


The .DOFSS directive assumes that RO contains the starting address of 
the string and that the string itself is in ASCIZ format (terminated 
with a zero byte). See the discussion of .FSS in Chapter 3 for an 
explanation of how the string is processed. The data returned on 
completion of .DOFSS is the same as for .FSS. 
Note that .DOFSS, like all RSTS/E-specific directives under RTll, is 
not expanded at assembly time. (It is not defined in the SYSMAC.SML 
file as a directive.) You can code a definition of the directive ina 
data section of your program or use .MACRO to define it. See the 
following example. 
Privileges Required 
None 
Macro Call 

-DOFSS 


Errors 


The errors for .DOFSS are the same (and in the same format) as for 
-FSS. 


Example 


The following code checks the string FILE.NAM to see if it is a valid 
RSTS/E file specification: 


-DOFSS = EMT+365 


STG: -ASCIZ /FILE.NAM/ 
MOV #STG,RO 
-DOFSS 


. DORUN 
(RSTS/E Only) 


»DORUN -- Chain to Non-RT11 RTS Program 


Use the .DORUN directive to transfer control to programs that run 
under a non-RT1ll run-time system. 


Note 


The .DORUN directive must be used from programs 
running under the RT1ll run-time system, rather than 
the .RUN directive, since RT1ll keeps user logical 
information in a different area in low-core than the 
monitor expects. 


The .DORUN directive causes the emulator to restore the user logical 
information to its normal place in the low 512. bytes of memory and 
translates an RT1l1l file specification to the proper form in the FIRQB 
for a .RUN. 


The .DORUN assumes that RO contains the address of a five-word file 
definition. The first four words contain a normal RT1l1l "device block" 
specification (see Chapter 6); the last word contains a parameter to 
be passed to the run-time system at FIRQB+FQNENT. If the address 
passed in RO points to a device block within an outspec area returned 
by a previous .CSISPC directive, all of the RSTS/E-specific 
information from the file specification (PPN, and so forth) is loaded 
into the proper area in the FIRQB. Values in the first six words of 
the scratch pad area take precedence over the values found in the 
string examined by .CSISPC. 


Privileges Required 
Execute access to the specified program. 
Macro Call 

- DORUN 
Note that .DORUN, like all RSTS/E-specific directives under RTll, is 
not expanded at assembly time. (It is not defined in the SYSMAC.SML 
file as a directive.) You can code a definition of the directive ina 
data section of your program or use .MACRO to define it. See the 
following example. 


Errors 


Errors are returned as for a .RUN directive. 


. DORUN 
(RSTS/E Only) 


Example 


The following program uses .CSISPC to scan a user-entered file 
specification, ensures that the program is entered with a zero 
parameter passed to the run-time system, and then attempts to execute 
the file with .DORUN. If an error occurs for either the .CSISPC or 
the .DORUN, an error message is printed at the job’s terminal. The 
code follows: 


-SETFQB = EMT+360 ;Define EMT for SETFQB 
-DORUN = EMT+363 ;Define EMT for .DORUN 
-CSISPC OUTSPC,DEFEXT,0 ;Read, scan command string 
BCS ERROR ;Command string in error 
MOV OUTSPC,R0O ;Get devblk for first file 
CLR 4*2(R0) ;Pass 0 at FIRQB+FQNENT 
- DORUN ;Try to run the file 
ERROR: .PRINT #ERRMES ;An error occurred 
.- EXIT 


ERRMES: .ASCIZ /?Can’t run that file/ 


- DSTATUS 


»DSTATUS - Return Device Status 


The .DSTATUS directive returns information about a device to a 
four-word area defined in the user program. 


Privileges Required 
None 
Macro Call 
-DSTATUS stablk,devnam 
where: 


stablk is the address of a four-word area to contain the returned 
status information. 


devnam is the address of one word containing a device and unit 
number, in RAD50 format. The word can also be a 
three-character user logical name in RAD50 format. 


Information Returned to Statblk 


i. fee ae i 
Gee a ee 
ares eaaecen se 
ee eae | 
5 ei + 


Status Word Format 
tonne ee eee eee eee tence eee ee ee eee “+ 
| flags | handler index | 


The low byte contains the RT11 handler index for the device: 


Octal 
Value Device 


(disk) 
DT (DECtape ) 
LP (line printer) 
KB (keyboard) 
PR (paper tape reader) 
PP (paper tape punch) 
MT (magnetic tape) 
CR (card reader) 


her ON DP WE O 


bps pe 


-DSTATUS 


The high byte describes the device characteristics. Note that you can 
combine the device-characteristics flags. For example, a value of 
140000 for the entire word would indicate a file-structured, read-only 
disk. The word values are: 


Device 
Characteristics 

(Octal Word Value) Meaning 
100000 Device is file-structured 
040000 Device is read-only 
020000 Device is write-only 

Errors 

Code Meaning 

0 The device named in the devnam argument is not known on the 
system. 

Example 


The following code checks for status information for MTO: 


STAT: - BLKW 4 
DEVNAM: .RAD50 /MT0/ 


-DSTATUS #STAT,#DEVNAM 


- ENTER 


~-ENTER - Open File for Output 


The .ENTER directive creates a new file and associates the file with a 
channel number. You then use the channel number to refer to the file 
for other I/O operations. 


A RSTS/E “tentative open" is done; that is, the file is not permanent 
until a .CLOSE is executed with the same channel number as specified 
in the .ENTER directive. Then, the tentative file is made permanent, 
and any already existing file of the same name on the same device is 
deleted. A .PURGE, .HRESET, or .SRESET directive deletes the 
tentative file; any already existing file of the same name on the same 
device is left intact. 


You can preallocate space for disk files by setting an argument in the 
call. Note that you can also set a PPN, protection code, mode, and 
other RSTS/E parameters applicable to opening a file for output by 
setting words in the scratch pad area (see Chapter 6). 
Privileges Required 
Write access to the file. 
Macro Call 

-ENTER area,chanum,devblk,len,seqnum 
where: 


area is the address of a four-word argument block. 


chanum is a channel number in the range 0 to 17 (octal). See 
Chapter 6 for rules on channel numbers. 


devblk is the address of a four-word device-block containing the 
device and file specifications. See Chapter 6 for the 
format of this area. 


len is the file size to be preallocated for the file, in 
512-byte blocks (for disk files only). Values can range 
from 1 to 32767. For large disk files on RSTS/E, you must 
set the Most Significant Bits (MSB) byte in the scratch pad 
area (see Chapter 6). RSTS/E ignores a zero or negative 
value. 


seqnum is ignored on RSTS/E systems. 


- ENTER 


Argument Block Format 


+---------- toe cee eee + 
| Z | chanum | €——=(RO) 

+----- eee Sr + 

| devblk | 

Se t--- eee eee + 

| len | 

+--- ee eee ee toner eee + 

| seqnum | 

+---- eee ee terre ere ee + 

Errors 

Code Meaning 

0 Channel is already in use. 

1 The file cannot be preallocated to the specified size, or the 


device is full. 
Example 


The following code opens the file NEWFIL.SAV on MTO for output: 


AREA: - BLKW 4 
DEVBLK: .RAD50 /MTONEWFILSAV/ 
- ENTER #AREA,#1,#DEVBLK, #0, #0 


e ERRPRT 
(RSTS/E Only) 
~ERRPRT ~- Print RSTS/E Error Message 
The .ERRPRT directive prints the RSTS/E error message text 
corresponding to an error code on the user terminal. The call assumes 
that the error code is in RO. The text is printed without a 
carriage-return/line-feed combination. 
Privileges Required 
None 
Macro Call 
» ERRPRT 
Note that .ERRPRT, like all RSTS/E-specific directives under RTll, is 
not expanded at assembly time. (It is not defined in the SYSMAC.SML 
file as a directive.) You can code a definition of the directive ina 
data section of your program or use .MACRO to define it. See the 
following example. 
Errors 
No errors are possible with the .ERRPRT directive. 


Example 


-MCALL -EXIT, .PRINT, .REGDEF 
- REGDEF 


-ERRPRT = EMT+364 


-CSECT 
START: MOV 256.,R1 ;Number of errors to print 
CLR RO Start with error zero 
10S: - ERRPRT ;Print error text 
MOV RO,-(SP) ;Save RO 
-PRINT #CRLF Print a CRLF 
MOV (SP)+,R0 sRestore RO 
INC RO ;Inc RO for next message 
SOB R1,10$ ;Loop until all are printed 
~ EXIT 
CRLF: -BYTE 0 
- END START 


EXIT 


~-EXIT - Program Exit 
The .EXIT directive terminates execution of the calling program. On 
exiting from the calling job, the RSTS/E monitor drops any temporary 
privileges still in effect. Then, control passes to the job keyboard 
monitor at the keyboard monitor entry point (see P.NEW in Chapter 2). 
Note 
The job keyboard monitor is the default keyboard 
monitor unless the job has issued the SET 
JOB/KEYBOARD_MONITOR command or has issued a general 
monitor .RTS directive (see Chapter 3) to specify a 
job keyboard monitor. 
If RO = O when the .EXIT is executed, any channels still open will be 
released, without the usual clean-up operations. In particular, any 
temporary files (opened with .ENTER and not yet closed) will be 
deleted. 
Note 
Programs running under the RT1l1l run-time system must 
use the RT11 .EXIT directive, not the general monitor 
~-EXIT or .RTS directive. 
Privileges Required 
None 
Macro Call 
- EXIT 
Errors 
No errors are possible with the .EXIT directive. 


Example 


The following code exits such that files opened with .ENTER and not 
yet closed will be deleted: 


SAVOLD: MOV #0,R0 
EXIT 


- FETCH 


~FETCH ~- Check Whether Device Exists 


On RSTS/E systems, the .FETCH directive checks to see if a specified 
device exists on the system. 


Privileges Required 
None 
Macro Call 
-FETCH addr,devnam 
where: 
addr is ignored on RSTS/E. 
devnam is the address of a one-word, RAD50 device name. The format 


of this word is the same as that described for the first 
word of a device block (see Chapter 6). 


Errors 

Code Meaning 

0 The device specified does not exist on the system. 
Example 


The following code checks to see if LPO exists on the system: 


DEVNAM: .RAD50 /ULP0/ 


. FETCH #0,#DEVNAM 


. GETCOR 
(RSTS/E Only) 


-GETCOR -- Changes Job Image Size 


This directive changes the amount of space currently allocated for 
the user job image. The RT11 emulator checks to ensure that the 
requested expansion will not destroy the scratch pad area, moves the 
scratch pad area if necessary, and then expands the job image size 
using the .CORE directive (see Chapter 3). Thus, the same rules 
concerning size changes for .CORE also apply to .GETCOR. 


The .GETCOR directive assumes that the new job image size, in K 
words, is in RO. If the required expansion is not possible, the 
carry bit will be set on return from the call. Otherwise, the size 
change succeeds, and word 44 now points to the new location for the 
start of the scratch pad area. 


Note 


Programs running under the RT11 run-time system must 
use .GETCOR, not the general monitor .CORE directive. 


You must use .GETCOR to expand the job image size 
before you use .CHAIN to transfer control to a 
program that requires more memory than the current 
program. 

Privileges Required 

EXQTA privilege is required to exceed the job’s memory limit. 

Macro Call 

-GETCOR 


Note that .GETCOR, like all RSTS/E-specific directives under RTll, is 
not expanded at assembly time. (It is not defined in the SYSMAC.SML 
file as a directive.) You can code a definition of the directive ina 
data section of your program or use .MACRO to define it. See the 
following example. 


Errors 


If the requested change cannot be made, the carry bit is set on return 
from the call. 


.GETCOR 
(RSTS/E Only) 


Example 


The following code uses 


-GETCOR to expand the user job image area to 
24K words before doing a .CHAIN: 


-GETCOR = EMT+366 


MOV #24.,R0 
. GETCOR 

BCS ERRTN 

- CHAIN 


-GTLIN 


-GTLIN ~ Get Line from Job’s Terminal 


The .GTLIN directive accepts a line of input from either the job’s 
terminal or core common and stores it in a buffer for later 
examination by the user program. You can also specify an ASCIZ string 
to be displayed at the terminal before the line is accepted. 


.GTLIN reads the line from core common instead of the job’s terminal 
if the program is invoked with a parameter word of 8192. For example, 
the parameter word normally has this value when a program is run by a 
CCL command. A second .GTLIN causes the program to exit. 


By default, .GTLIN returns a string in uppercase. To obtain lowercase 
letters, set bit 14 in the Job Status Word (JSW) before you issue the 
~-GTLIN. 


Privileges Required 
None 
Macro Call 
.GTLIN linbuf[,prompt] 
where: 
linbuf is the address of an area to receive the input line. Up to 
81 bytes can be accepted from a terminal, so the buffer 
should be at least that long. The line is stored in memory 
and terminated with a zero byte instead of with a 
Carriage-return/line-feed combination. 
prompt is the address of a string to be printed on the job’s 
terminal before input is accepted. The string itself must 
be terminated with a zero byte or a 200 (octal) byte. If 
the string is terminated with a zero byte, the display ends 
with a carriage-return/line feed. If terminated with a 200 
(octal) byte, the display ends after the prompt string. 


Errors 


No errors are possible with the .GTLIN request. 


-GTLIN 


Example 


The following example prompts the job’s terminal and accepts a line of 
input: 


PROMPT: .ASCIZ /YES OR NO?/ 
LINBUF: .BLKB 81. 
-GTLIN #LINBUF, #PROMPT 


- GVAL 


-GVAL - Get Value from Scratch Pad 
The .GVAL directive returns the contents of a word in the scratch pad 
area to RO. You specify an offset from the beginning of the scratch 
pad. 
Privileges Required 
None 
Macro Call 
-GVAL area,offset 
where: 
area is the address of a two-word argument block. 
offset is the offset, in bytes, from the beginning of the scratch 
pad area of the word desired. The offset value must be 
even. An odd offset causes a trap to kernel mode vector at 


four. 


Argument Block Format 


terre eee eee t---- +e eee + 
| 34 | 0 | —( (RO) 

5 ee tee rece eee + 

| offset | 

Se terre ee eee + 

Errors 

Code Meaning 

0 The offset given is beyond the limits of the scratch pad area. 
Example 


The following example returns the contents of the PROTEC offset in the 
scratch pad area to RO: 


AREA: - BLKW 2 


-GVAL #AREA, #2 


-HRESET 


~HRESET -- Hardware Reset 

The .HRESET (hardware reset) directive closes all open channels for 
the program without performing any of the normal clean-up operations 
(except to disassociate the RT11 channel numbers from their RSTS/E 
counterparts). For example, no trailer labels are written to magnetic 


tape, no form feed is given for the line printer, and so forth. 
Temporary files (created with .ENTER but not yet closed) are deleted. 


Privileges Required 
None 
Macro Call 
-HRESET 
Errors 
No errors are possible with the .HRESET directive. 
Example 


-HRESET 


- LOOKUP 


~LOOKUP - Open File for Input 


The .LOOKUP directive opens an existing file and associates it with a 
channel number; in RSTS/E terms, an OPEN FOR INPUT statement. The 
channel used is then busy until one of the following directives is 
executed: 


- CLOSE 

-SAVESTATUS 

-SRESET 

-HRESET 

- PURGE 

.CSIGEN (if the channel number is in the range 0 to 8) 


Note that you can set a PPN applicable to a RSTS/E OPEN FOR INPUT 
statement by setting the appropriate words in the scratch pad area 
before executing the .LOOKUP (see Chapter 6). 
Privileges Required 
For disk files, you need read access. If the device is restricted, 
you need DEVICE privilege. You need RDNFS privilege to access disks 
in non-file-structured mode. 
Macro Call 

-LOOKUP area,chanum,devblk,seqnum 
where: 


area is the address of a three-word argument block. 


chanum is a channel number in the range 0 to 17 (octal). See 
Chapter 6 for rules on channel numbers. 


devblk is the address of a four-word device block containing the 
device and file specifications. See Chapter 6 for general 
rules on the format of device blocks. 


The file name portion of the device block is ignored for 
non-file-structured devices, such as a paper tape. If you 
want to do non-file-structured I/O on a file-structured 
device, clear the first word of the file name portion of the 
device block. 


seqnum is ignored on RSTS/E systems. 
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- LOOKUP 


Argument Block Format 


+------ ce + 
| l | chanum | <€=(RO) 
t----e- cs + 
| devblk | 
+--- +--+ --- Sr + 
| seqnum | 
te -- 5 ee eee tere ere eee + 
Errors 
Code Meaning 
0 Channel already open. 
1] The file requested (in the device block) was not found. 
Example 
ERRBYT=42 
ARGBLK: .BLKW 5 ;Leave space for arg block 
DEVBLK: .RAD50 /DT3/ ;Define device, 
-RAD50 /DATA 001/ ;Filename and type 


. LOOKUP #ARGBLK,#7,#DEVBLK ;Open on channel 7 


BCC LDONE :;File was found 
TSTB @#ERRBYT ;Error--test further below 
BNE NFD ;File not found 
. PRINT #CAMSG ;Print ’'Channel Active’ 
EXIT 

NFD: . PRINT #NFMSG :;PRINT ’File not found’ 
~EXIT 

CAMSG: .ASCIZ /Channel active/ 

NFMSG: .ASCI2 /File not found/ 


«PRINT 


-PRINT - Display String on Job’s Terminal 


The .PRINT directive displays a specified ASCII string on the job’s 
terminal. The line can be terminated with or without a 
carriage-return/line-feed combination. Note that on RSTS/E systems, 
if the terminal is detached when a .PRINT is issued, the job 
hibernates. That is, execution of the job is suspended until the 
terminal is reattached to the job. 


Privileges Required 
None 
Macro Call 
-PRINT stradd 
where: 
stradd is the starting address of the string to be printed. The 
string itself must be terminated with either a zero byte or 
a byte value of 200. If the string is terminated with a 
zero byte, the display ends with a carriage-return/line-feed 
combination. If the string is terminated with a 200 byte, 
the display ends with the string. 


Errors 


No errors are possible with the .PRINT directive. 


Example 
Sl: -ASCIZ /String will have CR-LF following/ 
S2: -ASCII /String will have no CR-LF following/ 
. BYTE 200 
. EVEN 
-PRINT #S1 
- PRINT #S2 


- PURGE 


»PURGE - Release Channel 
The .PURGE directive can be used to release a channel when it is not 
desirable to close the file normally. Any temporary file created by a 
-ENTER is discarded. A .PURGE on a file that was opened with .LOOKUP 
will cause no action other than to free the channel; any data written 
to the file will still be there. If the specified channel is not 
open, the .PURGE is simply ignored; no error is returned. 
Privileges Required 
None 
Macro Call 

-PURGE chanum 


where: 


chanum is a channel number in the range 0 to 17 (octal). See 
Chapter 6 for rules on channel numbers. 


RO Format 
terre eee eee Heer ee ee eee + 
(RO) = | 3 | chanum | 
+e eee ee eee teen ee ee eee + 
Errors 


No errors are possible with the .PURGE directive. 
Example 
The following example verifies that channels 0 to 7 are free: 


-TITLE .PURGE.MAC 


-MCALL - PURGE, .EXIT 
START: 
CLR Rl sStart with channel 0 
1$ . PURGE Rl ;Purge a channel 
INC Rl ;Bump to next channel 
CMP R1,#8. ;Is it at channel 8 yet 
BLO 1$ 
~EXIT 
. END START 


-RCTRLO 


e-RCTRLO -- Reset CTRL/O 

The .RCTRLO directive restarts any programmed output to the user’s 
terminal after such output has been stopped by the user-entered CTRL/O 
or CTRL/C. 

Terminal service on RSTS/E maintains a "discard all program output" 
indicator for each terminal on the system. When this indicator is 
set, the driver ignores any output requests for that terminal. When 
the indicator is clear, output to the terminal proceeds normally. The 
-RCTRLO directive clears this indicator. 


The driver sets the indicator when the user enters a CTRL/C or CTRL/O 
combination and reverses it when the user enters a CTRL/O again. 


Thus, when it is important that a message get through to the terminal, 
use a .RCTRLO directive before the .PRINT or other request for output 
to make sure that the message is displayed regardless of any 
user-entered CTRL/O or CTRL/C. 
Privileges Required 
None 
Macro Call 

- RCTRLO 
Errors 
No errors are possible with the .RCTRLO directive. 


Example 


The following example forces the message to be displayed on the user’s 
terminal: 


EOW: -ASCIZ /The end of the world is nigh/ 
- RCTRLO 
- PRINT # EOW 


- READ 
e-READW & .READC 


»READ/.READW/.READC - Read Data 


On RSTS/E systems, .READ, .READW, and .READC transfer data from a file 
or device previously opened on a channel to a user buffer. Once the 
transfer is complete, control returns to the user program inline, for 
»READ and .READW, or to a user-specified completion routine, for 
»READC. You specify the maximum number of words to be transferred; 
the actual number of words transferred is returned in RQ. 


Note that you can set a modifier word in the scratch pad area for 
devices that use this information. See the .READ directive in Chapter 
3 for possible values of the modifier word. 

Privileges Required 

None 

Macro Call 


- READ 
area,chanum,bufadd,wrdcnt,blknum 


- READW 
Or 

-READC area,chanum,bufadd,wrdcnt,cmprtn,blknum 
where: 

area is the address of a five-word argument block. 


chanum is a channel number in the range 0 to 17 (octal), previously 
defined in an open (.LOOKUP). 


bufadd is the address of a buffer to contain the data to be read. 


wrdcnt is the maximum number of words to be read. The actual 
number of words read may be less than wrdcnt; it is never 
more, The actual number of words transferred is returned in 
RO. 


cmprtn is the address of a completion routine to which control is 
transferred when the read is complete. (For .READC only.) 


blknum is the block number relative to the start of the file where 
the read is to begin (for files opened with file-structured 
-LOOKUP). To access large files on RSTS/E systems, you must 
set the word at offset 2 in the scratch pad area; see 
Chapter 6. 


- READ 
e-READW & .READC 


For devices opened with non-file-structured .LOOKUP, blknum 
is the absolute block number or device cluster number where 
the read is to begin. 

For successive reads, your program must increment blknum. 


Argument Block Format 


5 +--+ eee eee + 
| 10 | chanum | 
| +r cree eee + 
| blknum | 
5 tore reece + 
| bufadd | 
5 tee eee eee + 
| wrdcnt | 
terre tee tence nee + 
| cmprtn* | 
t---- eee tore eee eee + 


*(The last word = 0 for .READW, or 1 for .READ.) 


Errors 

Code Meaning 

0. Attempt to read past end-of-file (EOF). 
1 Hard error occurred on channel. 

2 Channel is not open. 

Example 


The following code reads data from the device open on channel 7 to a 
512. byte user buffer: 


AREA: - BLKW 5 
BUF: - BLKW S12: 
- READ #AREA,#7,#BUF,#512.,#0 


-RENAME 


e-RENAME ~ Rename a File 


The .RENAME directive changes the name of a file on disk or DECtape 
and gives that file the current date in its directory entry. If a 
file with the new name already exists on the specified device, it is 
deleted. 


Privileges Required 


If the device is restricted, you need DEVICE privilege. For disk 
files, you need create/rename access to the file. 


Macro Call 
-RENAME area,chanum,namblk 

where: 
area is the address of a two-word argument block. 
Cchanum is ignored on RSTS/E systems. 


namblk is the address of an eight-word area containing two 
four-word device and file descriptor blocks (see Chapter 6). 
The first four-word block is the old file name and the 
device where it is stored. The second four-word block is 
the new file name; the device descriptor must be specified, 
and must be the same as the device descriptor in the first 
four-word block. If a PPN is specified in the first six 
words of the scratch pad, it is used for both the old and 
the new file. If a protection code is given in the first 
six words of the scratch pad, it is used for the new file. 
Other values in the first six words of the scratch pad are 
ignored. 


Argument Block Format 


torre eee eee tere cee eee e + 
| 4 | chanum | €=(RO) 

+---- ++ eee terre eee eee + 

| devblk | 

fern e ee eee torre reece + 

Errors 

Code Meaning 

1 No file with the "old" name was found on the device. 
2 The device specified is not a disk or DECtape. 


- RENAME 


Example 


The following code renames file OLDFIL.MAC to NEWFIL.MAC: 


AREA: . BLKW 2 
NAMBLK: .RAD50 /DT3/ 
.RAD50 /OLDFIL/ 


.RAD50 /MAC/ 
-RAD50 /DT3/ 
- RAD50 /NEWFIL/ 
-RAD50 /MAC/ 


- RENAME #AREA, #0, #NAMBLK 


- REOPEN 


»REOPEN - Reopen File Closed with .SAVESTATUS 
The .REOPEN directive reopens a file that was closed with a 
»~SAVESTATUS directive. You can use a different channel number than 


was used in the original .LOOKUP and .SAVESTATUS, as long as the new 
channel is not already open. 


The .SAVESTATUS and .REOPEN directives are easier to use than .CLOSE 
and .LOOKUP, if your program needs to open more than 15 files during 
its execution. The .SAVESTATUS directive retains the information 


necessary to reopen a file, including the PPN. Thus, you do not need 
to reset the PPN offset in the scratch pad area. 


Privileges Required 


If the device is restricted, you need DEVICE privilege. You need 
RDNFS privilege to access a non-file-structured disk. You need read 
access to the file. 


Macro Call 
-REOPEN area,chanum,chnblk 
where: 
area is the address of a two-word argument block. 


chanum is a free channel number in the range 0 to 17 (octal). See 
Chapter 6 for rules on channel numbers. 


cChnblk is the address of the five-word block where the channel 
status information was stored (see .SAVESTATUS). 


Argument Block Format 


+--+ ee eee 5 + 
| 6 | chanum | << (RO) 

beeen eee eee t-- eee eee + 

| chnblk | 

fewest eee ee +--+ - ee eee + 

Errors 

Code Meaning 

0 The specified channel is in use. The .REOPEN has not been done. 


- REOPEN 


Example 


The following code reopens a file closed with .SAVESTATUS using the 
device block area named SAVBLK: 


AREA: - BLKW 2 
SAVBLK: .BLKW 5 


- REOPEN #AREA, #6,#SAVBLK 


- SAVESTATUS 


-SAVESTATUS - Save Status of File for Later .REOPEN 


The .SAVESTATUS directive closes a disk or DECtape file, saving all 
the information needed to reopen the file later in execution of the 
program (see .REOPEN). The information saved is stored in a five-word 
area in the user program and includes the PPN for the file. Thus, the 
. SAVESTATUS/.REOPEN combination is easier to use on RSTS/E systems 
than .CLOSE/.LOOKUP in this case; you do not have to set the PPN 
offset in the scratch pad area. 


The .SAVESTATUS directive can be used only if the file was opened with 
-LOOKUP. If the file was opened with .ENTER, a .SAVESTATUS on that 
channel returns an error. 
Privileges Required 
None 
Macro Call 
-SAVESTATUS area,chanum,chnblk 
where: 


area* is the address of a two-word argument block. 


Chanum is a channel number in the range 0 to 17 (octal), previously 
used in a .LOOKUP directive for disk or DECtape. 


chnbIlk is the address of a five-word area to store the current 
information for the file. On RSTS/E systems, the first four 
words of this area are set to the device, file name, and 
type, in the standard RT1l1 device-block format (see Chapter 
6). The last word of this area is set to the PPN of the 
file. 


Argument Block Format 


+--- ee ee eee to-rceee ---+ 
| 5 | chanur | 
Se torre ree eee + 
| chnblk | 
+--+ 2 eee eee Se + 


- SAVESTATUS 


Errors 

Code Meaning 

0 The channel specified is not currently open; that is, a previous 
- LOOKUP on the channel was never done. 

1 The file was opened with .ENTER, or else the file is not on a 


disk or DECtape device. The .SAVESTATUS is illegal. 


Example 


The following code saves the status of the file open on channel 12 for 
a later reopen: 


AREA: - BLKW 2 
SAVBLK: .BLKW 3 


-SAVEST #AREA,#12.,#SAVBLK 


-SCCA 


-SCCA ~- Pass CTRL/Z to User Program 


The .SCCA directive lets a user program recognize and process a CTRL/Z 
combination entered on the job’s terminal. When called with any 
nonzero value for the addr argument, subsequent CTRL/Zs entered at the 
job’s terminal are translated to an ASCII 3 and passed like any other 
character to the program when it issues a .TTYIN or .GTLIN. 

(Normally, a CTRL/Z causes the RT11 emulator to exit the running 
program when a .READ or .TTYIN is done.) 


Note 


The operation of the .SCCA directive is quite 
different under RSTS/E than under the RT-11 operating 
system, where it lets a user program trap CTRL/C 
combinations. 


The .SETCC directive must be used for this function 
under the RT1l1l run-time system under RSTS/E. The 
intent is to let you code an .SCCA directive to trap 
the delimiter equivalent in function on the two 
systems. 


On RSTS/E systems, CTRL/Z is the "type-ahead terminator." You can, for 
example, type RUN SMACRO, type the command line for the assembly, 
enter a CTRL/Z, and then type RUN S$LINK. You do not have to wait for 
the assembly to finish before typing the command to link. 
On RT-11 systems, CTRL/C is the "type-ahead terminator." Hence, the 
-SCCA directive processes the character appropriate to the system on 
both RSTS/E and RT-11 systems. 
Privileges Required 
None 
Macro Call 

-SCCA area,addr 
where: 

area is the address of a two-word argument block. 

addr is a switch. Any nonzero value for this argument causes 

CTRL/Zs to be passed to the user program, as described 


previously. A zero value returns CTRL/Z processing to the 
emulator. 


-SCCA 


Argument Block Format 


Se Se + 
| 35 | 0 | 
+o ree eee eee +e eee eee + 
| addr | 
tere cee eee + 
Errors 


No errors are possible with the .SCCA directive. 


Example 
The following code causes CTRL/Zs to be passed to the program: 


AREA: - BLKW 2 


-SCCA #AREA, #1 


.SETCC 
RSTS/E Only 


~SETCC - Process CTRL/C 
The .SETCC directive defines a routine to be entered when the user 
enters one CTRL/C on the job’s terminal. (Two consecutive CTRL/CS 
still aborts the running program.) The address of the routine to be 
entered is assumed to be in RQ when the .SETCC is executed. 
The .SETCC is only effective until the first CTRL/C; you must reissue 
the .SETCC from the trap routine if you want it to remain in effect. 
You must also reenable CTRL/O processing with .RCTRLO. Use an RTI 
instruction to exit from the trap routine. See the discussion of 
offset 66 in the scratch pad area in Chapter 6 for further information 
on CTRL/C processing under the RT1ll run-time system. 
Privileges Required 
None 
Macro Call 

~SETCC 
Note that .SETCC, like all RSTS/E-specific directives under RTll, is 
not expanded at assembly time. (It is not defined in the SYSMAC.SML 
file as a directive.) You can code a definition of the directive ina 
data section of your program or use .MACRO to define it. See the 
following example. 
Errers 
No errors are possible with the .SETCC directive. 


Example 


The following code defines a routine to be entered when the user 
enters a CTRL/C on the job’s terminal: 


~-SETCC = EMT+362 


MESAGE: .ASCIZ "You typed a CTRL/C!" 
MOV #CTLC,RO 
-SETCC 
CTLC: -RCTRLO 
-PRINT #MESAGE 
MOV #CTLC,RO 
-SETCC 
RTI 


.SETFQB 
(RSTS/E Only) 


~SETFQB - Set Up FIRQB 


The .SETFQB directive can be used after a .CSISPC; the two calls 
combined return information to the FIRQB and XRB as if the file 
specification string had been examined by .FSS. 


The call assumes that RO contains the address of the first word of a 
device block returned by .CSISPC. As noted in the discussion of 
-CSISPC, the device-block information must not have been moved; thus, 
the address in RO must be the address of the first word of a device 
block within the “outspc" area returned by the last .CSISPC. 


Note that any information in the first six words of the scratch pad 
area overrides any RSTS/E-specific information returned by the 
-CSISPC. In addition, the .SETFQB clears the first six words of the 
scratch pad after using the information. 
Privileges Required 
None 
Macro Call 

- SETFQB 
Note that .SETFQB, like all RSTS/E-specific directives under RTll, is 
not expanded at assembly time. (It is not defined in the SYSMAC.SML 
file as a directive.) You can code a definition of the directive ina 
data section of your program or use .MACRO to define it. See the 
following example. 
Errors 
No errors are possible with the .SETFQB directive. 


Example 


The following code returns information to the FIRQB and XRB about the 
file following the equal sign (=) in an RT command: 


~-SETFQB = EMT+360 


-CSISPC #OUT,#EXT,#CMD 
MOV #OUT+<3%*5*2>,R0 
- SETFQB 


-SETTOP 


-SETTOP -- Expand to Start of Scratch Pad 
On RSTS/E systems, the .SETTOP directive sets the contents of the word 
at location 50 in the low 512 bytes of memory to the value specified 
in .SETTOP. The value itself cannot equal or exceed the starting 
address of the scratch pad area (see Chapter 6). If such a value is 
specified, .SETTOP simply sets the contents of location 50 to the 
address of the first word after the starting address of the scratch 
pad. The value actually set in word 50 is also returned to RO on 
completion of the call. 
Privileges Required 
None 
Macro Call 

-SETTOP adrval 


wheres: 


adrval is a value specifying the address to which location 40 is to 
be changed. 


Errors 
No errors are possible with the .SETTOP directive. 
Example 


The following code sets the contents of location 50 to the address of 
the word after the start of the scratch pad: 


-SETTOP #-2 
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-SFPA 


-SFPA - Set Floating-Point Error Address 


The .SFPA directive indicates that you want to handle floating-point 
errors yourself. You specify the address of a routine to be entered 
if such errors occur. The .SFPA works for errors on both the FIS 
(floating-point instruction set on the PDP-11/40) and the FPP or FPU 
(hardware floating-point units on the PDP-11/45 and 11/70 asynchronous 
unit and its equivalents). In the case of FPP or FPU hardware, two 
words have been pushed on the stack: the Floating-Point Exception 
Code (FEC) at the top of the stack and the Floating Error Address 
(FEA) one word down. Your routine can process these words in any way 
it sees fit and should pop them from the stack before issuing an RTI 
instruction to return control to the program where it left off when 
the errors occurred. 


The .SFPA directive works only for one floating-point error trap. You 
must reexecute the .SFPA from your error-processing routine to ensure 
that successive errors are handled in the same way. You can disable 
traps to your error routine by issuing the .SFPA directive with a zero 
address argument. 
Note 

You should not use .SFPA in a routine called by a 

FORTRAN program, because programs compiled under 

FORTRAN have their own FPP/FIS exception handling 

routines and expect to find the FPU status as they 

have set it. 
Privileges Required 
None 
Macro Call 

-SFPA area,addr 

where: 


area is the address of a two-word argument block. 


addr is the address of the routine to be entered when a 
floating-point error occurs. 


Argument Block Format 


+-------- +----- eee + 
| 30 | 0 | 
+--+ -- ee +-------- + 
| addr | 
tee - ee eee +e re ee eee + 


-SFPA 


Errors 
No errors are possible with the .SFPA directive. 
Example 


The following code defines ERRTN as the address of the error routine 
to be entered when a floating-point error occurs: 


AREA: . BLKW 2 


e 


~SFPA #AREA, #ERRTN 


-SPFUN 


-SPFUN -- Special Functions for I/0 


The .SPFUN directive handles special functions for disk, terminal, 
magnetic tape, and flexible diskette. 


Privileges Required 
None 
Macro Call 
-SPFUN area,chanum,func,buf[,wcent)[,blk][,crtn] 
where: 
area is the address of a six-word argument block. 
chanum is a channel number in the range 0 to 17 (octal), defining 
the device on which the special function is to be performed. 
The channel must have been previously opened with .LOOKUP. 
func is a special function code. To request magnetic tape 


special functions emulating RT1l1l’s .SPFUN, set this argument 
to one of the following values: 


377 Write end-of-file 
376 Forward 1 record 

375 Backspace 1 record 
373 Rewind to load point 
372 Offline rewind 


Any other value for this argument is used as the function 
code (at XRB+XRLEN) in a RSTS/E .SPEC directive (see Chapter 
3). 


buf is used as the value of the word at XRB+XRLOC in a RSTS/E 
-SPEC directive. It must be set to zero if the func 
argument is 377, 376, 375, 373, or 372. 


went is used as the value of the word at XRB+XRBC in a RSTS/E 
-SPEC directive. It is ignored (and can be omitted) if the 
func argument is 377, 376, 375, 373, or 372. 


blk is used as the value of the word at XRB+XRBLK in a RSTS/E 
-SPEC directive. It is ignored (and can be omitted) if the 
func argument is 377, 376, 375, 373, or 372. 


crtn is the address of a completion routine to which control is 
to be transferred when the operation is complete. If this 
argument is omitted, control returns to the instruction 
following the .SPFUN when the operation is completed. 


7-66 


-SPFUN 


Note that if you are using .SPFUN to do a RSTS/E .SPEC, the RT1l 
emulator fills in the RSTS/E channel number and device handler values 
in the XRB for you. 


Argument Block Format 


i tee eee eee + 
32 | chanum | 
Se +---- ee eee + 
blk | 
+e -- eee eee t--r eer cere + 
buf | 
+-- 27-5 - eee +--+ - eee ee + 
went | 
+e -- ee ee eee +--+ -- cee ee + 
func | 377 | 
+--- eee eee t-- reece eee + 
| crtn | 
+--+ 22+ eee i + 
Errors 
Code Meaning 
0 Tried to read past end-of-file. 
1 Hard error occurred on channel. 
2 Channel is not open. 
ixample 


The following code rewinds a magnetic tape (open on channel 4): 
AREA: - BLKW 6 


- SPFUN #AREA, #4,#373, #0 


-SRESET 


-SRESET -~- Software Reset 
On RSTS/E systems, the .SRESET directive does the same thing as a 
hardware reset (.HRESET). It closes all open channels for the program 
without performing any of the normal clean-up operations (except to 
disassociate the RT1l1 channel numbers from their RSTS/E counterparts). 
For example, no trailer labels are written to magnetic tape, no form 
feed is given for the line printer, and so forth. Tentative files 
(created with .ENTER but not yet closed) are deleted. 
Privileges Required 
None 
Macro Call 

- SRESET 
Errors 
No errors are possible with the .SRESET directive. 


Example 


- SRESET 


-TRPSET 


-TRPSET - Intercept Traps to 4 and 10 


The .TRPSET directive allows the user program to trap to a user 
routine on errors that normally cause the program to abort execution. 
Control passes to the address specified in the call when the job tries 
to execute a reserved instruction (normally trapped to kernel mode 
address 10) or issues an instruction with an odd address (normally 
trapped to kernel mode address 4). 


The carry bit indicates which error occurred. When control is passed 
to the error-handling routine, the carry bit is zero if the error was 
an odd-address error. If the carry bit is one, the error was a 
reserved-instruction error. An RTI instruction will return control to 
the user program from the trap routine. 
Note that the .TRPSET directive affects only the next error causing 
such a trap. You must reissue the .TRPSET from your error-handling 
routine if you want to handle such errors consistently. 
Privileges Required 
None 
Macro Call 

-TRPSET area,addr 
where: 


area is the address of a two-word argument block. 


addr is the address to which control is to be passed when a 
reserved-instruction or odd-address error occurs. 


Argument Block Format 


tree eee eee tree eee eee + 
| 3 | 0 | 
tote eee t--- eee eee + 
| addr | 
+o eee eee Se + 
Errors 


No errors are possible with the .TRPSET directive. 


-TRPSET 


Example 


The following code defines TRPRTN as the address of the routine to be 
entered when a reserved-instruction or odd-address error occurs: 


AREA: - BLKW 2 


- TRPSET #AREA, #TRPRTN 


TRPRTN: BCC ODDADR 
(code for reserved instruction) 


ODDADR: (code for odd address) 


~-TTYIN 
-TTINR 


~-TTYIN/.TTINR ~- One-Character Read From Terminal 


The .TTYIN and .TTINR directives both accept input from the job’s 
terminal and transfer one character to the low byte of RO. 


Bits 6 and 12 of the job status word (JSW) affect how the transfer is 
done. 


If bit 12 of the JSW = 0, the .TTYIN/.TTINR waits until a whole line 
has been typed at the job’s terminal and then transfers one character 
to the low byte of RO. Succeeding .TTYIN/.TTINR requests will then 
transfer remaining characters, including carriage return and line 
feed. In addition, the usual monitor processing for terminal input 
occurs: all characters typed are echoed at the terminal, and CTRL/U 
and DELETE delete a line or a character, respectively. 


If bit 12 of the JSW = 1, ODT-mode input is done. That is, characters 
are transferred when they are available, rather than waiting for a 
whole line to be typed before passing a character to the user program. 
One .TTYIN/.TTINR transfers one character. Furthermore, characters 
typed are not echoed at the terminal, and CTRL/U and DELETE are simply 
passed on to the user program. (CTRL/C and CTRL/O are processed as 
usual, however. CTRL/S and CTRL/Q are processed, if that option was 
requested for your terminal with TTYSET.) No ALTMODE conversion is 
done. 


If bit 6 = 1, control returns to the:user program with the carry bit 
set if no character can be returned to the program. Note that this 
should only be used with .TTINR, and only when the program needs to 
perform other processing while waiting for terminal input. If bit 6 = 
0, control does not return to the user program until a character can 
be passed to the program. 


If used, bits 6 and 12 in the JSW must be set by the user program; 
they are cleared automatically when a program terminates. 


Note 


Single character I/O places heavy demand on RSTS/E 
system resources and can degrade system performance. 
These calls are provided only for compatibility with 
RT-1ll. 


-TTYIN 

-TTINR 

Privileges Required 
None 

Macro Calls 


.TTYIN [addr] 


or ; 
-TTINR 
where: 
addr is the address of a location where the character is to be 
stored, in addition to being stored in RO. If the address 
is omitted, the character is stored only in RQ. 
Errors 
Code Meaning 
0 No character or characters are available in the monitor buffer 
for terminal I/0 (only applies to .TTINR). 
Example 


The following code transfers one character from the job’s terminal to 
the low byte of RO: 


» TTYIN 


~TTYOUT 
- TTOUTR 


eTTYOUT/.TTOUTR -- Transfer One Character to Job’s Terminal 
The .TTYOUT and .TTOUTR directives both transfer one character from 
the low byte of RO to the job’s terminal. Using .TTYOUT or .TTOUTR is 
slower than uSing .PRINT because they require more system overhead. 
Use .PRINT whenever possible. 
Note that on RSTS/E systems, if the terminal is detached when a 
-TTYOUT or .TTOUTR is executed, the job hibernates. That is, 
execution of the job is suspended until the terminal is reattached to 
the job. 
Privileges Required 
None 
Macro Call 

.TTYOUT [addr] 


or 
. TTOUTR 


where: 
addr is the address of a memory location containing the character 
to be printed. The character is loaded into RO first. When 
control returns from the call, RO still contains the 
character. If you omit this address, RSTS/E prints the 
character in the low byte of RO at the job’s terminal. 


Errors 


No errors are possible with the .TTYOUT and the .TTOUTR directives 
under RSTS/E. 


Example 


The following example transfers one character from the low byte of RO 
to the job’s terminal: 


PROMPT: .ASCII J*/ 
MOV # PROMPT, RO 
. TTYOUT 


-TWAIT 


-TWAIT ~- Timed Wait 


The .TWAIT directive suspends execution of the job for a specified 
number of clock ticks: a sleep, in RSTS/E terms. 


Privileges Required 
None 
Macro Call 
.TWAIT area,addr 
where: 
area is the address of a two-word argument block. 
addr is the address of a two-word block specifying the length of 
time to sleep in units of 1/60th second. The first word 
contains the high-order bits; the second word contains the 


low-order bits. 


Argument Block Format 


terre eee eee tore eee eee + 
| 24 | 0 | 
toe eee e eee tree ee eee + 
| addr | 
toe - teense terse eee + 
Errors 


No errors are possible with the .TWAIT directive. 
Example 


The following code suspends program execution for 5 seconds: 


AREA: . BLKW Z 

ADDR: - BLKW 2 
CLW #ADDR 
MOV #300.,#ADDR+2 
. TWAIT #AREA, #ADDR 


WAIT 


»oWAIT - Check for Channel Open 


On RSTS/E systems, the .WAIT directive checks to make sure that the 
specified channel is open. If not, the call returns with an error. 


Privileges Required 
None 
Macro Call 

-WAIT chanum 
where: 


chanum is the channel number to be tested. The number can be in 
the range 0 to 17 (octal). 


RQ Format 
t------ eee te-- errr eee + 
RO = | 0 | chanum | 
t------ eee to- ree eee ee + 
Error 
Code Meaning 
0 The specified channel is not open. 
Example 


The following code checks to see if channel 7 is open and branches if 
it is not: 


-WAIT #7. 
BCS #NOTOPN 


-WRITE 
-WRITW & .WRITC 


~WRITE/.WRITW/.WRITC -- Write Data 


On RSTS/E systems, .WRITE, .WRITW, and .WRITC transfer data from a 
user buffer to a file or device previously opened on a channel. After 
the transfer is complete, control is passed to the user program 
inline, for .WRITE and .WRITW, or to a user-specified completion 
routine, for .WRITC. The number of words actually written is returned 
in RO when the call completes. 


Privileges Required 


EXTQA privilege suppresses disk quota checks when extending a disk 
file. 


Macro Call 


-WRITE 
-WRITW 


| area,chanum,bufadd,wrdcnt,blknum 
or 

-WRITC area,chanum,bufadd,wrdcnt,cmprtn,blknum 
where: 

area is the address of a five-word argument block. 


chanum is a channel number in the range 0 to 17 (octal), previously 
defined in an open (.ENTER or .LOOKUP). 


bufadd is the address of the buffer containing the data to be 
written. 


wrdcnt is the number of words to be written. 


cmprtn is the address of a completion routine to which control is 
transferred when the write is complete. (For .WRITC only.) 


For .WRITE and .WRITW, control is returned to the 
instruction following the directive when the write is 
complete. 


blknum is the block number relative to the start of the file where 
the write is to begin. (For files opened with 
file-structured .ENTER or .LOOKUP. ) 


For devices opened with non-file-structured .ENTER or 
.LOOKUP, the blknum argument is used as the absolute block 
number or device cluster number where the write is to begin. 


-WRITE 
eWRITW & .WRITC 


Note 
To access large files on RSTS/E systems, you must 
set the word at offset 2 in the scratch pad area 
(see Chapter 6). 


To do successive writes, your program must increment 
blknum. 


Argument Block Format 


tr - eee eee terre eee eee + 
11 | chanum | 

te - eee ee eee terre ree eee + 
blknum | 
i to -reee eee + 
bufadd | 
+----- ee ee | + 
wrdcnt | 

i Se + 
cmprtn* | 
t--- ee eee teen e ee eee + 


*The last word is set to 1 for .WRITE or to 0 for .WRITW. 


ELrrors 
Code Meaning 
0 No more room is available on the device. For example, the 


end-of-tape (EOT) marker has been encountered, no more available 
disk space, and so forth. 


a Some hard I/O device error occurred. For example, the specified 
device is offline, is physically write-locked, and so forth. 


2 The channel specified is not open. 
Example 


The following code writes a 256-word block to the device open on 
channel 12: 


AREA: - BLKW 5 
BUF: - BLKB S12. 
-WRITE #AREA,#12.,#BUF,#256.,#0 


Vis 
eevee. 


--V1l../..V2.. ~ Use Version l1/Version 2 Expansion 


If you have a source program that was coded for Version 1 or Version 2 
of the RT-11 operating system and you want to assemble on RSTS/E using 
the expansions that were used for these versions, you must use either 
the ..Vl.. directive (for Version 1 expansions) or the ..V2.. 
directive (for Version 2 expansions). 


You cannot use both the ..Vl.. and ..V2.. directives. You can use 
directives from more than one version by specifying the ..Vl.. 
directive and simply using the directives from later versions. If the 
same directive exists in two or three versions, though, you get the 
expansion from the earliest version. 


These directives generate code that defines and sets a variable called 
-.--Vl to either 1 or 2, which the MACRO assembler uses to determine 
the expansions to use. So, if the ..Vl.. or ..V2.. directive is used, 
it must appear before any other RT1l1 directives in your program. 
Note 

All the examples in this chapter show Version 2 

expansions. Version 1 expansions require different 

arguments in the calls. See RT-11 system 

documentation if you need to use version 1 

expansions. 
Privileges Required 


None 


Macro Call 


or 


asa Videos 


Appendixes 


Appendix A: Full List of Errors 


This appendix lists the error messages that you may encounter when 
using RSTS/E. The question mark (?) and percent sign (%) characters 
preceding the full error text indicate the error’s severity: 


o A single question mark precedes nonfatal errors; the command 
failed but you can continue 

o A double question mark precedes severe errors; the command 

failed and you cannot continue 


o A percent sign precedes a warning message; the command may 
not have performed as you intended but execution continues 


Informational messages have neither character; 
detail about the effects of a command. 


they provide extra 


Table A-1 summarizes the RSTS/E error messages. 


Table A-l: RSTS/E Errors 
poten tee eee tere eee on tee re ee ee ee ee ee ee eee ee ee eee ee eee + 
| ERR.STB | Decimal | Octal | | 
| Mnemonic | Value | Value | Full Error Text | 
tose e eee ee t+-- eee -et--------- penn ee re ee ee eee ee ee ee ee ee eee + 
| | | | | 
| BADDIR 1 1 | ??Bad directory for device | 
| BADNAM 2 2 | PIllegal file name | 
| INUSE 3 3 | ?Account or device in use | 
| NOROOM 4 4 | ?No room for user on device | 
| NOSUCH 5 5 | ?Can’t find file or account | 
| NODEVC 6 6 | ?Not a valid device | 
| NOTCLS 7 7 | ?I/O0 channel already open | 
| | | 
| NOTAVL 8 10 | ?Device not available | 
NOTOPN 9 et | ?PI/O channel not open | 
PRVIOL 10 12 | ?Protection violation | 
EOF 11 13 | PEnd of file on device | 
ABORT 12 14 | ??Fatal system I/O failure | 
DATERR 13 TS | ?PData error on device | 
HNGDEV 14 16 | ?PDevice hung or write locked | 
HNGTTY 15 17 | ?Keyboard wait exhausted | 


Full List of Errors 


Table A-l: RSTS/E Errors (Cont.) 
+-- ee ee eee +--------- tee - ee eee terre ee ee ee ee ee ee ee eee 
| ERR.STB | Decimal | Octal | 
| Mnemonic | Value | Value | Full Error Text 
tere eee eee +--+ ----- +-e- eee eee He ee ee ee ee ee ee eee 
| | | 
| FIEXST | 16 20 | ?PName or account now exists 
| DTOOOF | 17 | 2h | ?Too many open files on unit 
BADFUO | 18 22 | ?Illegal SYS () usage 
| INTLCK | 19 | 23 | ?Disk block is interlocked 
WRGPAK | 20 24 | ?Pack IDs don’t match 
NOTMNT | 21 | 25 | ?Disk pack is not mounted 
PAKLCK 22 | 26 | ?Device is restricted 
BADCLU | 23 | ot | ?PIllegal cluster size 
| | 
PRIVAT | 24 | 30 | ?PAccount does not exist 
INTPAK Zo | 31 | $Disk pack needs REBUILDing 
BADPAK | 26 | 32 | ??Disk pack mount error 
DETKEY | 27 | 33 | ?I/O to detached keyboard 
CTRLCE 28 | 34 | Programmable ~C trap 
SATTBD | 29 | 35 | ??Corrupted file structure 
DEVNFS 30 | 36 | ?PDevice not file-structured 
| BADCNT 31 | i | ?PIllegal byte count for I/0 
| | | 
NOBUFS 32 | 40 | ?PNo buffer space available 
I iB 33 | 41 | 2?0dd address trap 
B.10 34 | 42 | ??Reserved instruction trap 
B.250 | 35 | 43 | ??Memory management trap 
B.STAK 36 | 44 | ??SP stack overflow 
B.SWAP | 37 | 45 | ?P?Disk error during swap 
B.PRTY | 38 | 46 | ??Memory parity failure 
MAGSEL | 39 | 47 | ?PMaptape select error 
| | | 
MAGRLE | 40 | 50 | ?Maptape record length error 
NRRTS | 41 | 51 | ??Non-res run-time system 
VCSERR | 42 | 52 | ?PVirtual buffer too large 
| VCAERR | 43 | 53 | ?PVirtual array not on disk 
SIZERR | 44 | 54 | ?Matrix or array too big 
VCOERR 45 55 | ?PVirtual array not yet open 
BSERR 46 56 | ?Illegal I/O channel 
LINERR 47 | 57 | ?Line too long 
| 
FLTERR | 48 | 60 | Floating point error 
EXPERR | 49 61 | SArgument too large in EXP 
FMTERR 50 | 62 | @Data format error 
FIXERR 51 63 | Integer error 
BDNERR | Sz 64 | ?Illegal number 
LOGERR | oS 65 | S@Illegal argument in LOG 
SQRERR | 54 66 | SImaginary square roots 
SUBERR | 35 67 | ?Subscript out of range 
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Full List of Errors 


A-3 


Table A-l: RSTS/E Errors (Cont.) 
terre eee eee +------- i terete ee ee ee ee ee ee eee ee ee eee + 
| ERR.STB Decimal | Octal | | 
| Mnemonic Value | Value | Full Error Text | 
pee ee ee eee pr pe ee pe ee ee ee ee ee ee ee et 
| | | 
MINVER 56 | 70 | ?PCan’t invert matrix | 
ODD | 57 | 71 | ?POut of data | 
ONBAD | 58 | t2 | 2?ON statement out of range | 
NEDERR | 59 | 73 | PNot enough data in record | 
IOLERR | 60 | 74 | PInteger overflow, FOR loop | 
DIVBYO | 61 | qo | Division by 0 | 
NORTS | 62 | 76 | ?NO run-time system | 
FIELDE | 63 | a | ?FIELD overflows buffer | 
| | | | 
NORACS | 64 | 100 | ?Not a random access device | 
NOTMTA | 65 | 101 | ?PIllegal MAGTAPE() usage | 
ERRERR | 66 | 102 | ?Missing special feature | 
BADSWT | 67 103 | PIllegal switch usage | 
EOV 68 | 104 | ?End of volume | 
QUOTA | 69 105 | ?PQuota exceeded | 
70 | 106 | ??Unused ERROR message 70 | 
STMERR 71 107 | ?Statement not found | 
| | | 
EXITTM | 72 110 | PRETURN without GOSUB 
EXITNR a3 lil | ?PFNEND without function call | 
UNDFNI | 74 LZ | ?PUndefined function called 
COSERR fis | 113 | ?PIllegal symbol 
TLOPNV | 76 114 | ?Illegal verb 
TLNZSP 77 115 | PIllegal expression | 
TLNOIT 78 116 | ?Illegal mode mixing | 
TLIFFE 79 | 117 | ?Illegal IF statement | 
| | | 
TLCONI | 80 | 120 | PIllegal conditional clause | 
TLNOTF | 81 121 | Pillegal function name | 
TLODUM 82 | 122 | ?Illegal dummy variable | 
TLMFND 83 123 | ?Illegal FN redefinition | 
TLRNNM 84 | 124 | ?Illegal line number(s) 
MODERR | 85 125 | ?Modifier error 
86 | 126 | ?Can’t compile statement 
OUTOAS | 87 127 | ?PExpression too complicated | 
| | 
FUNERR | 88 | 130 | PArguments don’t match 
TLTMAF | 89 | 131 | ?Too many arguments 
TLINCD | 90 132 | SInconsistent function usage | 
CPNSDF 91 133 | ?PIllegal DEF nesting 
CPUPFR | 92 | (134 | ?PFOR without NEXT | 
CPUFNX 93 135 | ?NEXT without FOR | 
CPUPDF 94 | 136 | ?PDEF without FNEND | 
CPUPED 95 137 | ?FNEND without DEF | 


Full List of Errors 


Table A-l: RSTS/E Errors (Cont.) 
+o eee eee ee +o -- eee eee +o--- eee ee ter er ee eee ee ee ee ee ee eee eee eee 
| ERR.STB | Decimal | Octal | 
| Mnemonic | Value | Value | Full Error Text 
toe eee ee eee +----- eee tore eee eee ee 
| | | | 
| TLINKY | 96 | 140 | ?PLiteral string needed 
| TLNOFN | 97 | 141 | ?Too few arguments 
| SASYNE | 98 | 142 | ?PSyntax error 
| SAFNOS | 99 | 143 | ?String is needed 
| SASNOI | 100 | 144 | ?Number is needed 
| TLURTP | 101 | 145 | ?Data type error 
| TLXDIM | 102 | 146 | ?1 or 2 dimensions only 
| FUCORE | 103 | 147 | ??Program lost-sorry 
| | | | 
| RESERR | 104 | 150 | ?RESUME and no error 
| DIMED2 | 105 | 1 | ?Redimensioned array 
| TLIDIM | 106 | Lo2 | SInconsistent subscript use 
| NOGOTO | LOW | 153 | PON statement needs GOTO 
| EOSERR | 108 | 154 | PEnd of statement not seen 
| TLCNTD | 109 | 155 | ?What? 
| TLPRNM | 110 | 156 | ?Bad line number pair 
| EDBMCE | 111 157 | ?Not enough available memory 
| | | | 
| EDEXON | 112 160 | ?Execute only file 
| NRNERR | 113 | 161 | PPlease use the RUN command 
| EDCONE | 114 162 | ?Can’t CONTinue 
| EDARSV | E15 | 163 | ?File exists-RENAME/REPLACE 
PRERRS | 116 164 | ?PPRINT-USING format error 
| UDMERR | 117 | 165 | ?Matrix or array without DIM 
PRNERI] | 118 166 | ?Bad number in PRINT-USING 
| NONOIM | 119 | 167 | ?Illegal in immediate mode 
| | 
| PRNER2 | 120 | 170 | ?PRINT-USING buffer overflow 
BADERR | 121 171 | ?Illegal statement 
| DISERR | 122 | 172 | PIllegal FIELD variable 
STPERR | 123 173 | Stop 
DIMERR | 124 174 | PMatrix dimension error 
NOMATH | 125 | 175 | ?Wrong math package 
XCDCOR | 126 | 176 | ??Maximum memory exceeded 
SCAERR | 127 | LT i | *SCALE factor interlock 
| | | | 
| 128 | 200 | ?Tape records not ANSI 
| 129 | 201 | ?Tape BOT detected 
| 130 | 202 | ?Key not changeable 
| 131 | 203 | ?PNo current record 
| 132 | 204 | ?Record has been deleted 
| 133 | 205 | PIllegal usage for device 
| 134 | 206 | PDuplicate key detected 
| 135 | 207 | ?Illegal usage 
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Full List of Errors 


Table A-l: RSTS/E Errors (Cont.) 


+--- ee ee eee +--+ ------ +--------- tener eee eee ee ee ee ee ee eee ee eee eee + 
| ERR.STB | Decimal | Octal | | 
| Mnemonic | Value | Value | Full Error Text | 
fee eee eee terre renee te -- eee eee peer ee ee ee eee eee eee + 
| | | | 
| 136 | 210 | ?Illegal or illogical access | 
| 137 | 211 | ?Illegal key attributes | 
| 138 | 212 | ?File is locked | 
| 139 | 213 | ?PInvalid file options | 
| 140 | 214 | PIndex not initialized | 
| | 141 | 215 | ?Illegal operation | 
| 142 | 216 | ?Illegal record on file | 
| 143 | 22:7 | ?Bad record identifier | 
| | | | 
| 144 | 220 | ?PInvalid key of reference | 
145 | 221 | ?Key size too large | 
| 146 | 222 | ?Tape not ANSI labeled 
| 147 | 223 | ?PRECORD number exceeds max 
148 | 224 | ?Bad RECORDSIZE on OPEN | 
149 | 225 | ?PNot at end of file | 
150 | 226 | ?No primary key specified | 
| 151 | 227 | ?Key field beyond record end | 
| | | 
152 | 230 | PIllogical record accessing | 
153 | 231 | PRecord already exists | 
154 | 232 | ?PRecord/bucket locked | 
155 | 233 | ?Record not found | 
156 | 234 | ?PSize of record invalid | 
157 | 235 | ?PRecord on file too big | 
158 | 236 | ?PPrimary key out of sequence | 
159 | 237 | ?PKey larger than record | 
| | | | | 
| 160 | 240 | ?Pile attributes not matched | 
| 161 | 241 | ?Move overflows buffer | 
| | 162 | 242 | ?Cannot open file | 
| 163 | 243 | ?No file name | 
| 164 | 244 | ?Terminal fmt file required | 
| | 165 245 | ?Cannot position to EOF | 
| 166 246 | ?Negative fill or string len 
| 167 247 | ?Illegal record format 
| | | 
| | 168 250 | ?Illegal ALLOW clause 
| | 169 | 251 | ??Unused ERROR message 169 | 
| | 170 | 252 | PIndexed not fully optimized 
| | L71 | 253 | ?PRRV not fully updated | 
| | 172 | 254 | ?PRecord LOCK failed | 
| | 173 | 255 | PInvalid RFA field | 
| | 174 | 256 | ?PUnexpired file date | 
| | 175 | 207 | ?Node name error | 
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Full List of Errors 


Table A-l: RSTS/E Errors (Cont. ) 


tence eee eee tere e ee eee tee c eee eee area 
| ERR.STB | Decimal | Octal | 

| Mnemonic | Value | Value | Full Error Text 

+o ---- eee tere cee eee tore eee ee pee ee ee ee ee ee ee eee 
| | 

| | 176 260 ?Negative TAB not allowed 

| | Lid 261 ?Too much data in record 

| | 178 262 ?OPEN error - file corrupted 
| | 179 263 ??Unused ERROR message 179 
| | 180 264 ?No support for op in task 
| | 181 265 ?Decimal overflow 

| | 182 266 ?Network operation rejected 
| | 183 267 ?REMAP overflows buffer 

| | 

| | 184 270 ?Unaligned REMAP variable 

| | 185 271 SRECORDSIZE overflows MAP 

| | 186 Ze ?Improper error handling 

| | 187 273 ?Illegal record lock clause 
| | 188 274 ??Unused ERROR message 188 
| | 189 275 ??Unused ERROR message 189 
| | 190 276 ??Unused ERROR message 190 
| | 191 21) ??Unused ERROR message 191 

| | 

| | 192 300 ??Unused ERROR message 192 
| | 193 301 ??Unused ERROR message 193 
| | 194 302 ??Unused ERROR message 194 

| | 

| | 

| 

| 

: 

| 


| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
Bb | 
195 | 303 | ??Unused ERROR message 195 
| 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 


196 304 ??Unused ERROR message 196 

197 305 ??Unused ERROR message 197 

198 306 ??Unused ERROR message 198 

| 199 307 ??Unused ERROR message 199 

| 200 310 ??Unused ERROR message 200 

201 311 ??Unused ERROR message 201 

| | 202 312 ??Unused ERROR message 202 

203 313 ??Unused ERROR message 203 

| | 204 314 ??Unused ERROR message 204 

205 315 ??Unused ERROR message 205 

206 316 ??Unused ERROR message 206 

| | 207 317 ??Unused ERROR message 207 
| 

| 208 320 ??Unused ERROR message 208 

| | 209 321 ??Unused ERROR message 209 

| 210 322 ??Unused ERROR message 210 

| 211 323 ??Unused ERROR message 211 

| 212 324 ??Unused ERROR message 212 

| 213 S25 ??Unused ERROR message 213 

| 214 326 ??Unused ERROR message 214 

| 215 327 ??Unused ERROR message 215 


A-6 


Full List of Errors 


Table A-l: RSTS/E Errors (Cont.) 


tort tee eee +-- 5 eee ee +--------- tere ee ee ee ee ee eee ee eee eee eee + 
ERR.STB Decimal Octal | | 
| Mnemonic Value Value | Full Error Text 

terre ee eee +------- a i + 

216 330 ??Unused ERROR message 216 

| alee a1 ??Unused ERROR message 217 

218 332 ??Unused ERROR message 218 

219 o35 ??Unused ERROR message 219 

220 | 334 ??Unused ERROR message 220 

| 221 335 ??Unused ERROR message 221 

222 336 ??Unused ERROR message 222 

223 339 ??Unused ERROR message 223 

| 224 340 ??Unused ERROR message 224 

| 225 341 ??Unused ERROR message 225 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 226 342 | ??Unused ERROR message 226 
| | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


227 343 ?String too long 
228 344 ?RECORDTYPES not matched 
| 229 345 ??Unused ERROR message 229 
230 346 ?No fields in image 
| 231 347 ?Illegal string image 
| 2352 350 ?Null image 
233 35.1 ?Illegal numeric image 
234 352 ?Numeric image for string 
235 353 ?String image for numeric 
236 354 ?TIME limit exceeded | 
| 239 355 Plst arg to SEQS$ > 2nd 
| 238 356 | ?PArrays must be same DIM | 
| 239 307 | PArrays must be square 
| 
240 360 | ?Cannot change array DIMs 
241 361 | ?Floating overflow 
242 362 | ?Floating underflow 
243 363 | ?CHAIN to non-existent line | 
244 364 | PExponentiation error | 
245 365 | PIllegal exit from DEF* 
| 246 366 | PError trap needs RESUME | 
247 367 | ?Illegal RESUME to SUBR 
| 
248 370 | PIllegal subroutine return 
249 371 | PArgument out of bounds 
| 250 372 | ?Not implemented 
Adi. a13 | ?PRecursive subroutine call 
252 | 374 | ?PFILE ACP failure 
253 375 | ?PDirective error 
| 254 376 | ??PUnused ERROR message 254 | 
| 255 S11 | ??Unused ERROR message 255 
+------e e ee +--------- te-- ee eee perc re re ee ee ee ee ee ee eee eee + 


Appendix Bs: Device Information 


This appendix summarizes MODE and RECORD values and other useful 
information for: 


oO 


oO 


O 


ie) 


eo) 


‘e) 


For your convenience, 


Disks 

Flexible diskettes 
Magnetic tape 

Line printers 
Terminals 


Pseudo keyboards 


and list the FIRQB and XRB offsets. 
point; values without a decimal point are in octal. 


This appendix is a quick reference. 


(except where otherwise noted) 


the tables show both decimal and octal values, 
All decimal values have a decimal 


See the RSTS/E Programming Manual 
if you need more detail on any topic. 


Device Information 
Disks 
Disks 


This section summarizes disk MODE values and lists the device cluster 
size and total size for each disk that RSTS/E supports. 


Table B-l summarizes disk MODE values for file-structured access. 


Table B-l: MODE Values for File-Structured Disk Access (FIRQB+FQMODE ) 


tere ee eee tener eee pr ee ee ee ee eee + 
| Decimal | Octal | Function | 
to-e eee eee t------- fen re ee ee ee ee ee ee ee eee eee + 
| 

| 0 0 Normal read/write 

| | 

| 1 1 Update 

| | 

| 2% 2 Append 

| 

| 4 4 Guarded update (4 + 1) 

| 

| 8 10 Special extend (RSTS/E updates file’s size and 

| retrieval pointers during extend operations) 

| 

| 16. 20 Create contiguous file 

| 

| 32. 40 

| 

| 64 

| 

| 

| 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
Create tentative file | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
100 | Create contiguous file conditionally 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


| 
| 
| 
| 
| 
128 ! 200 No supersede 
256. | 400 Random data caching (requires TUNE privilege) 
512 | 1000 Create file and place at beginning of directory 
| (with 2000) 
| 1024 , 2000 Create file and place at end of directory 
2048 : 4000 Sequential data caching (with 400) 
| 4096. , 10000 Read normally regardless 
: 8192 : 20000 Open file read-only 
! 16384 : 40000 Write UFD (requires WRTNFS privilege) 
tree e cree +------- Herne ee ee ee eee ee ee ee ee eee meee eee eee + 
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Table B-2 summarizes disk MODE values for non-file-structured access. 


Table B-2: MODE Values for Non-File-Structured Disk Access 
(FIRQB+FQMODE ) 


terre eee +------- terre ee ee ee ee ee ee ee ee ee eee ee eee ee eee + 
| Decimal | Octal | Function | 
toe eee ee +------- Sl + 
| | | 

Ors.) 0 | Access device clusters. | 

| | | 

128. °| 200 | Access disk blocks. | 

| | | 

512. | 1000 | Read beyond last writable portion of disk; | 

| | | suppress error logging. (Reserved for use by | 
| | | DIGITAL. ) | 
fer eee eee tere ceee per re ee ee ee ee ee ee ee ee eee + 


Table B-3 lists the device cluster size and device size (in 512-byte 
blocks) for each disk that RSTS/E supports. All values are decimal. 


Table B-3: Disk Device Sizes 


t------- +--------- ten rr re ee ee ee ee eee eee + 
| | Device | | 
| Cluster | 
Disk | Size | Device Size | 
+---+--- t------ eee 2 wee eee ee eee ee eee ee eee + 
| | | 
RX50 si 1 | 800 | 
| | | 
RKO5 | mf | 4800 | 
| | | | 
RKOSF | 1 | 4800 per unit; 2 units for each drive | 
| | 
{| RLOL 1 10220 | 
| RLO2 a 20460 
| 
| RD51 1 21600 
| | 
| RKO6 1 | 27104 | 
| | | 
RKO7 1 | 53768 
| 
RC25 1 50902 per unit; 2 units per spindle 
| 
RPO2 | 2 40000 
| 
RPQ3 | 2 80000 
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Table B-3: Disk Device Sizes (Cont.) 


+------- t----- eee ter rr ee ee ee ee ee ee ee ee eee 
| | Device | 

| | Cluster | 

| Disk | Size | Device Size 

tee eee ee tore eee ee tern rr ee ee ee ee ee ee ee ee ee eee ee eee 
| | | 

| RMO2 | 4 | 131648 

| | 

| RMO3 4 | 131648 

| | 

| RPOQ4 | 4 | 171796 

| | 

| RPOS | 4 | 171796 

| | 

| RA8O 4 | 237208 

| | | 

| RM8O | 4 | 242575 

| | | 

| RPO6 | 8 | 340664 

| | | 

| RA60_ | 8 | 400175 

| | | 

| RMOS | 8 | 500352 

| | | 

| RA81l | 16 | 888012 

t------- +--------- terre ee ee ee ee ee ee ee ee ee ee ee ee eee eee ee eee 
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Flexible Diskettes 
This section summarizes MODE and RECORD values for flexible diskettes. 


Table B-4 lists MODE values for flexible diskettes. 


Table B-4: Flexible Diskette MODE Values (FIRQB+FQMODE) 


+--------- te--ce- ee tener ee ee eee ee ee ee ee ee eee eee eee + 
| Decimal | Octal | Function | 
re +--+ ---- per ree ee ee ee ee ee ee ee ee ee ee ee eee + 
| | | | 
| 0. | 0 | Block mode | 
| | | 
| 16384. | 40000 | Sector mode | 


Table B-5 lists RECORD values for flexible diskettes. 


Table B-5: Flexible Diskette RECORD Values (XRB+XRBLK) 


8192. 20000 Access logical record 0 


| | | 
: 
| 

| 16384. 40000 | Write deleted data mark | 
| | | 
| | | 
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Magnetic Tape 
This section summarizes MODE and CLUSTERSIZE values for magnetic tape. 


Table B-6 lists MODE values for file-structured magnetic tape. 


Table B-6: MODE Values for File-Structured Magnetic Tape 


16384. 40000 Search for DOS-formatted file label 


(FIRQB+FQMODE ) 
tr - eee ee torre eee Hr ee ee ee ee ee ee eee + 
Decimal | Octal | Function | 
Se terre ee Hr ee ee ee eee ee ee ee eee + 
| | | 
0 0 | Read file label at current tape position | 
| | 
2% 2 | Do not rewind tape when searching for file | 
| | | 
| 16. 20 | Write over existing file | 
| | | 
| 325-1 40 | Rewind tape before searching for file | 
| | | | 
| 64. 100 | Rewind on CLOSE | 
| | | | 
| 128. 200 | Open for append | 
| | | 
| 512. | 1000 | Write new file label without searching | 
| | | 
| | | 
| | | 
| | | 


| 
24576. | 60000 Search for ANSI-formatted file label 
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Table B-7 lists CLUSTERSIZE values for file-structured magnetic tape. 
The value in FIRQB+FQCLUS is the sum of the values chosen from Table 
B-7. The default value is zero. 

Note 


The CLUSTERSIZE option is only effective when 
processing ANSI-formatted magnetic tape. 


Table B-7: CLUSTERSIZE Values for File-Structured Magnetic Tape Files 


Sl +------ eee eee torre eee eee prc ee ee eee eee + 
| Label Field Name | Decimal | Octal | Label Result | 
terre ree eee ee eee eee toner eee eee +--+ eee ee eee Heer ee ee eee eee + 
| | | | 
| Record format 0. | O | U = undefined.* | 
| | | | 
| 16384. | 40000 | F = fixed-length. | 
| | | | 
| 32767.4+1. | 100000 | D = variable length. | 
| | | | 
| -16384. | 140000 | S = spanned.** | 
| | | 
| Record length Between 0. | Between 0 | For U, always 0. | 
| (in bytes) and 4095. | and 7777 | For F, fixed record | 
| | | length. | 
| | | | For D, maximum record | 
| | | length. | 
| | | For S, not used.** | 
| | | | 
| System Dependent | 0. | O | M = carriage control | 
| (File | | | embedded. | 
' characteristics) | | | | 
| | | | | 
| | 4096. | 10000 | A = FORTRAN carriage | 
| | | | control. | 
| | | | 
| | 8192. | 20000 | (space) = implied | 
| | | | carriage control. When | 
| | | | printed, line feed | 
| | | | precedes and carriage | 
| | | | return follows each | 
| | | | record. | 
5 beer ree eee eee +------+----- Herr ee ee eee eee eee + 


| * RSTS/E undefined record formats cannot be processed directly | 
| by most of the other operating systems. | 
| ** RSTS/E does not support ANSI format S records. | 
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MODE values in non-file-structured magnetic tape processing have the 
form: 

MODE(FIRQB+FQMODE) = D+ P+S5S 
where: 


D (density) = 12.(14) for 800 bpi 
256.(400) for 1600 bpi, phase-encoded 


P (parity) = 0.(0) for odd 
1.(1) for even (800 bpi only) 


S (stay) = 0.(0) to clear MODE value after CLOSE 
8192.(20000) to retain MODE value after CLOSE 


Note that DIGITAL recommends the use of odd parity. When you use even 
parity, you cannot write binary data. In addition, many operating 
systems and tape drives do not support even parity. 


For information on magnetic tape special functions, the magnetic tape 
status word, and the file characteristics word, see the description of 
-SPEC for magnetic tape (see Chapter 3). 


Line Printers 
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This section summarizes line printer MODE and RECORD values. Table 
B-8 lists the MODE values for line printers. 


Table B-8: 


128. 


256. 


512. 


1024. 


Line Printer MODE Values (FIRQB+FQMODE) 


200 


400 


1000 


2000 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


Sets form length to number of lines per page for 
software formatting (512., 1000) and automatic 
page skip (2048., 4000). 


Changes the character 0 (zero) to O (letter 
"oh" ) . 


Truncates lines that are longer than unit was 
configured for instead of printing the rest of 
the line on the next physical line on the page. 


Enables software formatting. Forms control 
characters are > 200(8). 


Translates lowercase characters to uppercase 
characters. Applies only to uppercase and 
lowercase line printers. 


Skips six lines (that is, skips over perforation 
line) at the bottom of each form. 


Moves paper to top of hardware form. 


Suppresses form feed on CLOSE. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


torre eee eee ee eee i cc + 
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Table B-9 lists the RECORD values for line printers. 


Table B-9: Line Printer RECORD Values (XRB+XRMOD) 


Print over perforation (disables MODE 4000 for 
this output step). 


| | | 

| | | 

| | | 

| | | 

| 4. | 4 | Do not return control to program until output is 
| | | complete or an error occurs. 

| | | 

| 8. | 10 | Clear pending output buffers before buffering 

| | | characters for the request. 

| | | 

| 8192. | 20000 | Return control to program if output stall is to 
| | | occur. (See the .WRITE directive for more 

| | | information. ) 

toe eee eee +------- te eee ee ee ee ee ee eee ee ee ee eee 


Terminals 


This section summarizes MODE and RECORD values for terminals. 
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It also 


includes information about echo control mode and vVT100 ANSI-compatible 
escape sequences. 


Table B-10 lists MODE values for terminal input. 


Table B-103 


+---- poet 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


Decimal 


Ls 


2. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


Terminal MODE Values (FIRQB+FQMODE) 


Octal 


100 


Enable binary input from a terminal 
Reserved for TECO 
Suppress automatic CR/LF at right margin 


Enable echo control (turns off other modes and 
automatically enables MODE 4) 


Guard program against CTRL/C interruption and 
dial-up line hibernation 


Enable incoming XON/XOFF processing 
Reserved 


Enable use of RUBOUT as a delimiter on video 
terminals 


Set escape sequence mode 


Transparent control character mode 
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Table B-11 lists RECORD values for terminal input. 


Table B-ll: RECORD Values for Terminal Input (XRB+XRMOD) 


tert eee eee eee teeter eee pr ee ete ee eee 
| Decimal | Octal | Function 
terre tere ee eee +e - eee eee ee pe ee ee ee ee ee ee eee 
256. 400 Force interactive read (always obtain 
Gata from the user’s terminal, never from 
a command file) 
8192. 20000 Perform conditional input (execute input 


request without waiting for data to be 
available). 


| | | 

| | | 

| | | 

| | | 

| | | 

| | | 

| | | 

— 

| 32767.+1.+K | 100000+K | Perform multiterminal service input from 
| | | assigned keyboard number K. 

| | | 

| 32767.+1.+ | 140000+S | Perform multiterminal service input from 
| 16384.+S | | any assigned keyboard: 

| | | | 

| | | S = 0 | Wait until input is 

| | | | available from any 

| | | | terminal. The error ?Data 
| | | | error on device may occur 
| | | | due to a race condition 

| | | | with CTRL/C. 

| | | | 

| | | 1. < S < 255. | Wait up to S seconds for 
| | | 1 < § < 377 | input from any terminal 

| | | | and then return ?Data 

| | | | error on device if no 

| | | | input is available. 

| | | 

| | | S = 8192. | Request input 

| | | S = 20000 | immediately; return ?Data 
| | | | error on device if no 

| | | | input is pending. 

tees eee eee eee toe - ee eee teen ee eee ee ee eee bern tee ee ee ee eee ee eee eee 


Device Information 


Terminals 
Table B-12 lists RECORD values for terminal output. 
Table B-12: RECORD Values for Terminal Output (XRB+XRMOD) 
tone eee eee eee +---- wee eee Harn er ee ee ee ee ee eee eee + 
| Decimal | Octal | Function | 
terre eee eee eee Here eee eee Heer ee ee ee ee eee ee eee ee eee eee ee ee eee eee + 
| | | | 
| 256. | 400 | Declare echo control field (use with MODE | 
| | | 10). | 
| | | | 
| 4096. | 10000 | Output binary data to terminal. 
| | | | 
| 8192. | 20000 | Return control to program if output stall | 
| | | is to occur. (See the .WRITE directive | 
| | | for more information. ) | 
| | | | 
| 16384. | 40000 | Transparent control character mode. | 
| | | | 
| 32767.+1.+K | 100000+K | Perform multiterminal service output to | 
| | | assigned keyboard K. | 
Hone ee eee eee +e - eee eee ten ee ee er ee ee eee ee eee + 


In echo control mode, the system strips the parity bit from all 
characters. All characters returned to your program have ASCII values 
in the range 1 to 255. The system does not pass synchronization or 
editing characters to your program. Delimiters are passed to your 
program but are never echoed. 
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Table B-13 lists the echo control mode character set. 


Table B-13: Echo Control Mode Character Set 


175 is translated to escape 
(33). 


If the Alt_Mode 
characteristic is not in 
effect, 175 is data. 


Herre eee eee Here eee tect ete e eee eee ee ee ee ee ee ee ee eee 
| | | Code | 

| Type of | ASCII Code | Returned | 

| Character | (Octal) | to User | Comments 

tenner eee ee tere ere eee ee tree seer eee Horr rer ee ee ee ee eee eee eee 
| | | | 

| Ignored | 0 | | Used as filler for timing 

| | | | 

| Delimiters | Private | | Private delimiter. 

| | | | 

| | 3 | 3 | “Cc (CTRL/C). 

| | | | 

| | 4 | 4 | *“D (CTRL/D). 

| | | | 

| | 12 | 12 | Line feed. 

| | | | 

| | 14 | 14 | Form feed. 

| | | | 

| [£5 CS ake | Carriage return (with line 

| | | | feed appended). 

| | | | 

| | 32 | 32 | ~“Z (CTRL/Z); generates error 
| | | | 11(10). 

| | | | 

| i 33 | 33 | If the Escape Sequence 

| | | | characteristic is not in 

| | | | effect and escape character 
| | | | is received, 33 is returned 
| | | | to user and is treated as a 
| | | | delimiter. 

| | | | 

| | | | If the Escape Sequence 

| | | | characteristic is in effect, 
| | | | escape character triggers an 
| | | | escape sequence. The escape 
| | | | sequence is returned to user 
| | | | and the whole sequence is 

| | | | considered the delimiter. 

| | | | 

| | 175 | 33 or | If the Alt_Mode 

| | | 175 | characteristic is in effect, 
| | | | 

| | | | 

| | | | 

| | | | 

| | | | 

| | | | 


Table B-13: 


Type of 


Editing 


Data 


Synchro- 
nization 
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Echo Control Mode Character Set (Cont.) 


- 
| 
| 
| 
+ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
: 
| 
| 
| 
| 
| 
| 
| 


ASCII Code 
(Octal) 


177 


25 


40-137 
241-337 


140-176 
340-376 


140-176 
340-376 


21 


23 


Code 


to User 


40-137 
241-337 


100-136 
300-336 


140-176 
340-376 


If the Alt_Mode 
characteristic is in effect, 
176 is translated to escape 
(33). 


If the Alt_Mode 
characteristic is not in 
effect, 176 is data. 


RUBOUT (DEL character); on 
video terminals, generates a 
backspace followed by the 
paint character and another 
backspace; on hard-copy 
terminals, echoes deleted 
characters between 
backslashes(\\). 


“U (CTRL/U); repeatedly 
simulates RUBOUT until no 
characters remain in field. 


Normal 64-character graphic 
set. 


If the Lowercase=input 
characteristic is not set, 
lowercase letters are 
translated to uppercase. 


If the Lowercase=input 
characteristic is set, 
lowercase letters are 

returned to user. 


XON (CTRL/Q). Resume 
suspended output (if the 
TTSync characteristic is 
set). 


XOFF (CTRL/S). Suspend output 
(if the TTSync characteristic 


is set). 
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Table B-13: Echo Control Mode Character Set (Cont.) 


tee rete ee eee Herter e eee eee t----- eee Hen re ee ee ee ee ee ee eee eee + 
| | | Code | | 
| Type of | ASCII Code | Returned | | 
| Character | (Octal) | to User | Comments | 
terete tee eee tees eee ee eee too see ee eee pert ee ee ee ee eee ee ee eee + 
| | | | | 
| Other | ee 2p ope | - | Echoed as BEL (7) but | 
| | 7,10,11, | | otherwise ignored. | 
| | 13,16-20, | | | 
| | 22,24, | | | 
| | 26-31, | | | 
| pe | : 
| |) <ehyes | - | If the terminal is set No | 
| | | | TTSync, synchronization | 
| | | | characters are also echoed as | 
| | | | BEL (7) and ignored. | 
+---- eee eee +-------- eee t---- eee eee Se + 


Use .WRITE to declare a field. The .WRITE must include the value 400 
at XRB+XRMOD and the value N at XRB+XRBC. N, which must be between 1 
and the size of the buffer, describes how many bytes in the buffer 
represent the field declaration: 


N= 1 The byte contains field size and overflow handling 
information. The field size must be in the range 1 to 177. 
Adding 200 to the field size specifies keypunch overflow 
handling instead of normal overflow handling. 


N= 2 The first byte contains field size and overflow handling as 
described for N= 1. The second byte contains the ASCII 
value of the paint character. If this byte is 0 or N= 1, a 
space is the paint character. 


N > 2 The first (N-2) bytes contain a prompt to display on the 
terminal before the field. Byte (N-1) is the field size 
declaration as described for N = 1. The last byte is the 
paint character as described for N = 2. 
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Pseudo Keyboards 
This section summarizes MODE and RECORD values for pseudo keyboards. 
It also lists errors your program can receive on a pseudo keyboard 


output request. 


Table B-14 lists MODE values for pseudo keyboards. 


Table B-14: Pseudo Keyboard MODE Values (FIRQB+FQMODE) 


| | 
| System kills controlled job when the pseudo | 
| keyboard is closed | 
| | 
| | 
| | 


System detaches controlled job when the pseudo 
keyboard is closed 
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Table B-15 lists RECORD values for pseudo keyboards. 


Table B-15: RECORD Option Bit Values for Pseudo Keyboard Output 


(XRB+XRMOD ) 
+----- tr --- eee +------- 
| Bit | Decimal | Octal 
+----- +--+ ------ t----+-- 
| | | 
| oO | Le | 1 
| | | 
| | | 
| | | 
|) as 3 Ze | 2 
| | | 
| | | 
| | | 
| | | 
| 2 | 4 | 4 
| | | 
| | | 
| | | 
| 3 | 8. | 10 
| | | 
| | | 
| | | 
| | | 
| | | 
| 4 | 16. | 20 
| | | 
+----- +--+ ------ +------- 


= se ee te ee ee ee ee ewe wee ws ese se wee eeeeee = = BF PF PeFeewe ee = w 


If set, the system does not check job 
status before sending data to the pseudo 
keyboard. 


If set, the system tests whether pseudo 
keyboard is waiting for a system command 
(CTRL/C state) or is waiting for program 
input (KB wait state). 


If set, the system does not send data to 
the pseudo keyboard but instead returns 
control to the controlling job. 


If set, and there are no small buffers for 
keyboard input, the system waits until 
small buffers are available. However, your 
program receives the NOROOM error if the 
output buffer chain is full. 


If set, the system kills the job currently 
running at the pseudo keyboard. 


Table B-16 lists errors that your program can receive on a pseudo 


keyboard output request. 


Table B-16: Possible Errors on Pseudo Keyboard Output Request 


INUSE 


Job at pseudo keyboard is not ready for input 


| | | 
| | | 
| | | 
| NOROOM | No buffer space is available | 
| | | 
| NOSUCH | No controlled job exists at pseudo keyboard | 
| | | 
| CTRLCE | Job at pseudo keyboard is not in CTRL/C state | 
t---- eee tener ee ee ee ee ee eee ee ee ee ee ee ee eee + 


INDEX 


. A 
Abbreviation point (CCL), 3-90 
ABRTS, 5-5 
Account 

creating, 3-411 

deleting, 3-361 

reading data for, 

resetting data for, 
Account number 

, 3-110 

S$, 3-110 

%, 3-110 

@, 3-110, 3-266 

file specification, 

wildcard, 3-111 
Accounting information dump, 


3-425 
3-425 


3-110 


3-284 
Active Page Register 
See APR 
Addressing, 2-1, 2-2 
Allocating a device, 3-15 
ALUNS, 5-6 


AME (Application Migration 
Executive), RSX emulator, 4-1 
ANALYS program, 3-415 
ANSI magnetic tape 
CLUSTERSIZE values, B-7 
Application Migration Executive 
See AME 
APR (Active Page Register), 
2-2, 2-6, 2-24, 2-26 
kernel mode, 2-5, 3-151 
used to map windows, 3-161 
user mode, 2-5 
Argument block, RT1l1l directives, 
6-7 
Assembler, 1-3 
ASSFQ, 3-15 to 3-18 
-AST, 3-12 
AST (Asynchronous Trap), 
5-55 
ASTXS, 5-8 
Asynchronous exception, 
handler, 2-29 
Asynchronous Trap 
See AST 
ATRFQ, 3-156 to 3-159 


2-1, 


2-18, 


5-8, 5-55 


ATRGS, 5-10 
Attach to job, 3-299 
Attribute, 3-288, 3-373 


-B- 


-10, kernel mode vector, 2-27 
-250, kernel mode vector, 2-27 
-4, kernel mode vector, 2-27 
-PRTY, 2-31 
-STAK, 2-31 
B.SWAP, 2-31 
Back spacing magnetic tape, 
BASIC-PLUS 
run-time system, 1-1, 2-6, 
SYS calls, 3-279 to 3-489 
Binary file 
creating, 
opening, 
Binary mode, 
-BLKBO, 3-7 
-BLKWO, 3-7 
BLOCK option, 
3-499 
Block-random devices, 
Block-sequential devices, 
BPT instruction, 2-18 
Broadcast to terminal, 
-BSECT, 3-6 
Buffer size 
reads, 3-189 
writes, 3-497 
Buffering, disabling full line, 
3-257 
Byte-oriented devices, 


wnoww ww 


3-230 


2-25 


3-22 
3-22 
3-241 


3-191, 3-197, 3-493, 
3-189 


3-189 


3-237 


3-189 
“C- 


Caching 

disabling disk, 3-325 

enabling disk, 3-325 
CALFIP, 3-14 to 3-89 

summary of subfunctions, 
CALL, 3-7 
Call formats, 

6-7 

CALLR, 3-7 
CALLRX, 3-8 


3-14 


RT11 directives, 
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CALLX, 3-7 
Card reader 
reads, 3-189 
Carry bit, 7-69 
CCL command, 3-90 
adding, 3-310 
deleting, 3-310 
/DETACH switch, 3-92 
getting command line, 5-34 
RT1l1 .DOCCL, 7-27 
/SIZE switch, 3-91 
string passed in CORCMN, 2-17 
-CCL directive, 2-17, 3-90 to 
3-94 
/DETACH switch, 2-35 
/SIZE switch, 2-35 
CCLLST, 3-470 
-CHAIN, 3-95 
RTl1, 7-7 to 7-8 
Channel 
checking for open, 7-75 
closing, 3-19, 7-45 
closing under RT1ll, 7-9, 7-68 
releasing, 7-49 
reset, 3-86 
Channel number, 3-10 
under RT11, 6-9 
-CLEAR, 3-96 to 3-97 
-CLEAR directive, 2-11 
-CLOSE, 7-9 
Close flag, 3-352 
CLOSE, negative channel number 
(reset), 3-86 
Closing a channel, 3-19 
-CLRFQB, 7-10 
CLRFQB routine, 3-9 
CLRFQX routine, 3-9 
-CLRXRB, 7-11 
CLRXRB routine, 3-9 
CLSFQ, 3-19 to 3-21 
CLUSTERSIZE option, 3-32, 3-40, 
3-76 
ANSI magnetic tape, B-7 
/CLUSTERSIZE switch, 3-108, 7-12 
CLUSTR offset, 6-16 
-CMDLN, 3-98 to 3-99 
Command, CCL, 3-90 
COMMON.MAC, 2-10, 3-3 to 3-8, 
3-279, 6-3 
how to assemble with, 3-4 
macros provided with, 3-4 


COMMON.MAC (Cont. ) 
mnemonics assigned to FIRQB, 
2-14 
mnemonics for pseudovectors, 
2-18 
Concise Command Language 
See CCL 
Context, job, 2-13 
Control characters, vertical 
format, 5-49t 
Conversion, date and time, 3-344 
CORCMN 
definition, 2-17 
format, 2-18f 
low 512 bytes, 2-10f 
-CORE, 3-100 to 3-103 
Core common, definition, 2-17 
-CORE directive, 2-12, 2-25 
CRAFQ, 3-160 to 3-166 
CRASH.SYS, DUMP/SYSTEM command, 
3-415 
CRAWS, 5-13 
CRBFQ, 3-22 to 3-28 


Create 
binary file, 3-22 
file, 3-29 


logged-in job to enter keyboard 
monitor, 3-381 
logged-in job to run program, 
3-379 
logged-out job, 3-377 
temporary file, 3-38 
CREFQ, 3-29 to 3-37 
CRMSBS offset, 6-16 
CRRGS, 5-18 
CRTFQ, 3-38 to 3-43 
-CSIGEN, 7-12 to 7-16 
-CSISPC, 7-17 to 7-20 
CSRTBL, 3-470 
CTRL/C, 2-18, 2-29, 2-30 
asynchronous exception, 5-55 
processing, 7-61 
restarting output stopped by, 
3-261 
Stopping action of, 6-16 
CTRL/O 
canceling, 3-237 
effect, 2-29, 2-30 
restarting output stopped by, 
3-261 
reversing, 7-50 
CTRL/Z, 7-59 
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DALFQ, 3-44 to 3-45 
Data caching 
See Caching 
Data space (D-space), 2-6 
Dataset, hanging up, 3-375 
-DATE, 3-104 to 3-105 
RT11, 7-21 to 7-22 
Date 
changing system, 3-347 
conversion, 3-344 
current, 5-37 
return to RO, 7-21 
returning under RT1l1l, 7-23 
-DATTIM, 7-23, 7-24 
DCL (DIGITAL Command Language) 
run-time system, 1-1 
DCL run-time system, 2-32 
DDB (Device Data Block), 3-367 
DDCTBL, 3-472 
DDNFS, 3-34, 3-78, 3-126, 3-127 
DDRLO, 3-34, 3-78, 3-126, 3-127 
DDWLO, 3-34, 3-78, 3-126, 3-127 
DEAFQ, 3-46 to 3-48 
Deallocate 
all devices, 3-44 
device, 3-46 
Declare receiver, 3-131 
DECnet/E, 3-131 
DECtape 
deleting file from, 3-57 
get directory for, 3-49 
reads, 3-189 
rename file, 3-82 
writing data, 3-497 
Default keyboard monitor, 2-31, 
3-107, 3-204, 7-36 
See also Primary run-time 
system 
Default runnable file type, 2-25 
Default system keyboard monitor, 
3-205 
DEFORG, 3-5 
-DELETE, 7-25 


Deleting 
account, 3-361 
file, 3-57 


Delimiters 
line, 3-189 
multiple private, 3-239 to 
3-250 


Delimiters (Cont. ) 
private, 3-239, 3-240 
Density, setting magnetic tape, 
3-230 
Detach 
resident library, 3-167 
/DETACH switch, in CCL command, 
3-92 
Detached job quota, 3-308 
Detaching job, 3-351 
DEVCLU, 3-472 
DEVCNT, 3-468 
Device 
allocating, 3-15, 3-262, 3-286 
block-random, 3-189, 3-497 
block-sequential, 3-189, 3-497 
byte-oriented, 3-189, 3-497 
checking availability, 7-37 
deallocating, 3-46, 3-262, 
3-274, 3-349 
deallocating all, 3-44, 3-270, 
3-346 
disk sizes, B-3 
handler index, 3-127 
logical name, 3-109, 3-123 
open (non-file-structured), 
3-73 
physical name, 3-109 
reading, 3-189 
reallocating, 3-262, 3-286 
record-oriented, 5-47 
return status, 7-31 
seize operation, 3-265 
writing data to, 3-490, 3-497 
zeroing, 3-486 
Device block, 6-9, 6-10 
creating, 7-17 
Device Data Block 
See DDB 
Device handler index, 3-35, 3-79 
Device-type flags, 3-34, 3-78, 
3-126 
DEVNAM, 3-470 
DEVOKB, 3-470 
DEVPTR, 3-468 
DEVSYN, 3-470 
DIC (Directive Identification 
Code), 4-3 
byte, DPB, 4-6 
DIGITAL Command Language 
See DCL 
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DIRS, 4-6 
general form, 4-6 
other features, 4-7 
Directive 
expansions for RSX, 4-2 
expansions for RTll, 6-4 
monitor, 1-5 
RSX, 1-5 
RT11, 1-5 
Directive Identification Code 
See DIC 
Directive Parameter Block 
See DPB 
Directive Status Word 
See DSW 
Directives 
emulator, 1-5 
Directory 
get information, 
lookup, 3-50 
lookup by file name, 3-394 
lookup on index, 3-355 
magnetic tape lookup, 
3-359 
privileged and nonprivileged 
access, 3-49 
wildcard lookup, 
DIRFQ, 3-49 to 3-56 
Disable terminal, 3-336 
Disk 
changing logical name of, 
changing quota, 3-336 
deleting file from, 3-57 
device cluster sizes, B-3 
device sizes, B-3 
directory lookup by file name, 


3-49 


3-358, 


3-396 


3-445 


3-394 
dirty bit, 3-402 
disabling caching, 3-325 
enabling caching, 3-325 


file lookup by name, 3-63 
get directory for, 3-49 
locking blocks, 3-220 
MODE values, B-2 
mounting, 3-399 

reads, 3-189 

rename file, 3-82 
Swapping to, 3-97, 3-215 


wildcard directory lookup, 
3-396 
writing data, 3-497 
Disk quota, 3-308 


DLNFQ, 3-57 to 3-59 
DMC11/DMR11 

number of receive buffers, 

3-76 

reads, 3-189 

receive buffer size, 

writing data, 3-497 
-DOCCL, 7-27 
-DOFSS, 7-28 
-DORUN, 7-29 
DPB (Directive Parameter Block), 

4-3 

$C form, 4-8 

DIC byte, 4-6 

S$ form, 4-6 

general form, 4-3 

$S form, 4-9 
SDPBSS, 4-9 
-DSECT, 3-5 
DSKLOG, 3-470 
-DSTATUS, 7-31, 
DSTPTR, 3-472 
DSW (Directive Status Word) 

return codes, 4-4 
SDSW mnemonic 

DSW (Directive Status Word), 
4-4 
3-167 to 3-170 


3-75, 


3-75, 3-76 


7-32 


DTRFQ, 

DTRGS, 5-21 

Dump, snap shot, 3-363, 3-415 

DUMP/SYSTEM command, CRASH.SYS, 
3-415 

Dynamic region, creating, 
3-439, 5-18 


3-430, 


-E- 


Echo 
disabling, 
enabling, 3-234, 
stopping, 3-260 

Echo control mode 
character set, B-1l14t 
declaring a field, B-16 

ELAFQ, 3-171 to 3-174 

ELAWS, 5-23 

EMT, 2-5€£ 
instruction, 2-21, 2-28, 6-4, 

6-6 
special prefix, 1-5, 2-23, 2-28, 


3-234, 3-237 


3-237 


EMT 377, 4-3 
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EMT logging, 3-132, 3-142 
Emulator, 1-2 
directives, 1-5 
RSX directives, 5-1 to 5-71 
RT11 directives, 7-1 to 7-78 
trap, 2-21 
End-of-file (EOF), magnetic tape, 
3-230 
-ENTER, 7-33 
Entry points, 2-31 
-EQUATE, 3-6 
ERLCTL, 3-470 
-ERLOG, 3-106 
ERR.STB 
symbol table file, 3-8 
ERRFQ, 3-60 to 3-62 
Error log, 2-24 
Error message 
printing text, 7-35 
returning text, 3-60, 3-365 
RSTS/E set, A-1l to A-7 
Error mnemonics, 3-8, A-1l to A-7 
Errors 
logging, 3-106 
pseudo keyboard output request, 
B-18 
»ERRPRT, 7-35 
Escape sequences, 3-240 
Escape sequences mode, 3-241 
Exception 
asynchronous, 2-29 
synchronous, 2-26, 5-60, 5-63 
»EXIT, 3-107 


RT1l1, 7-36 
EXITS, 5-25 
Expand 


memory allocation, 3-100 
memory size, 2-12 
Expiration date, changing, 3-336 
EXQTA privilege, 2-12 
EXSTS, 5-27 
Extend memory allocation, 3-100 
Extended Buffer Pool 
See XBUF 
Extended Record Block 
See XRB 
Extended-memory calls (RT11), 6-1 
EXTKS, 3-102, 5-29 


-F- 


FCB (File Control Block), 3-367 


FCBLST, 3-470 
FEA (Floating-point Error 
Address), 2-29, 5-8, 5-57, 
7-64 
FEC (Floating-point Exception 
Code), 2-29, 5-8, 5-57, 7-64 
-FETCH, 7-37 
File 
adding system, 3-455 
associating with run-time 
system, 3-403 
changing statistics, 3-304 
creating, 3-29 
creating binary, 3-22 
creating temporary, 3-38 
deleting, 3-57 
deleting from DECtape, 7-25 
deleting from disk, 7-25 
listing system, 3-455, 3-459 
lookup by name (disk), 3-63 
open existing, 3-73, 7-46 
open for input, 3-73, 7-46 
open for output, 7-33 
opening binary, 3-22 
opening file-structured, 3-29 
opening temporary, 3-38 
placement and modification, 
3-371 
processor, 3-279 
read attributes, 3-288 
read under RTll, 7-51 
reading, 3-189 
removing system, 3-455, 3-457 
renaming, 3-82, 7-53 
reopen, 7-55 
returning attribute, 3-373 
saving status of, 7-57 
specification, 3-109, 7-28 
spooling, 3-449 
tentative, 3-86 
wildcard lookup, 3-63 
write attributes, 3-288 
writing data to, 3-490, 3-497 
File access 
checking, 3-328 
File characteristics word, 
magnetic tape, 3-233 
File Control Block 
See FCB 
File name 
file specification, 3-111 
string scan, 2-18 
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File name string scan, 3-ll, 
3-108 
under RTll, 7-28 
File Processor 
See FIP 
File request queue block, 2-14 
File specification, 3-108 
order of elements, 3-112 
File type 
default runnable, 2-25 
file specification, 3-111 
File-structured, open, 3-29 
FILESIZE option, 3-31 
/FILESIZE switch, 3-108, 7-12 
FIP (File Processor), 3-89, 3-279 
calls, 3-89 
FIRQB 
clearing under RT1ll, 7-10 
data returned to, 3-10 
definition, 2-14 
general format, 2-15f 
low 512 bytes, 2-10f 
mnemonics assigned to, 2-14 
P.RUN entry, 2-36 
presetting to zero, 3-8 
routine to clear, 3-9 
setting up under RT1ll, 7-62 
Size of, 2-14 
translating string to, 3-109 
Fixed monitor locations, 3-152t 
Flag 
close, 3-352 
device-type, 3-34, 3-78, 3-126 
Flag word 1 (.FSS), 3-117 
Flag word 2 (.FSS), 3-114 
Flexible diskette 
changing density, 3-223 
MODE values, B-5 
obtaining density, 3-223 
reads, 3-189 
RECORD option, B-5 
special functions for, 3-223 
writing data, 3-497 
FLGFRC, 3-34, 3-78, 3-126, 3-127 
FLGKB, 3-34, 3-78, 3-126, 3-127 
FLGMOD, 3-34, 3-78, 3-126, 3-127 
FLGPOS, 3-34, 3-78, 3-126, 3-127 
FLGRND, 3-34, 3-78, 3-126 
Floating-point 
errors, 7-64 
processor, 2-18 


Floating-point (Cont. ) 
processor exception address, 
5-57 
processor exceptions, 5-8 
unit, 2-13, 2-29, 3-215, 7-64 
Floating-point Error Address 
See FEA 
Floating-point Exception Code 
See FEC 
Force to keyboard, 3-237 
Foreground/background, 6-1 
FREES, 3-470 
-FSS, 3-108 to 3-122 
I/O support, 3-11 
-FSS directive, 2-18 


-G- 


General monitor directives, 3-1 
to 3-502 
not used under RTll, 3-l 
summary, 3-1 
General Register RO, 6-5 
Get monitor tables 
Part I, 3-467 
Part II, 3-469 
Part III, 3-471 
-GETCOR, 7-38 
GLOBAL, 3-7 
Global symbols, 3-8 
GLUNS, 5-31 
GMCRS, 5-34 
GPRTS, 5-35 
-GTIM, 7-40 
GTIMS, 5-37 
-GTJB, 7-41 
-GTLIN, 7-42 
GTSKS, 3-102, 5-39 
-GVAL directive, 7-44 


-H- 


Handler index, device, 3-35, 3-79, 
3-127, 7-31 

Hanging up a dataset, 3-375 

High segment, 2-6, 2-9f, 2-18 to 
2-38 

Horizontal position, 3-186 

-HRESET, 7-45 
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IgD Space (Instruction and Data 
Space), 1-4, 2-6, 5-29 

memory management, 2-2 

I/O 
general directives for, 3-10 
non-file-structured, 5-46 
page, 2-5f 
RSX emulation environment, 5-46 
special functions for, 3-219 
special functions under RTll, 

7-66 

synchronous, 5-46 

I/O Status Buffer (ISB), 5-50 

- IDENT, 3-4 

INCLUDE, 3-5 

Infinite-wait read, 2-32, 3-192 

INIT, 2-6 

INSTALL/RUNTIME_SYSTEM command, 

2-21 

Instruction and Data Space 
See I&D Space 

Instruction space (I-space), 2-6 
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JBSTAT, 3-468 

JBWAIT, 3-468 

JFBIG, 3-96, 3-97, 3-215 
bit in KEY, 2-12 

JFFPP, 3-96, 3-97, 3-215 
bit in KEY, 2-13 

JFLOCK, 3-96, 3-97 
bit in KEY, 2-12 

JFNOPR, 3-96, 3-97, 

bit in KEY, 2-12 

JFPRIV, 3-96, 3-97, 3-215 
bit in KEY, 2-13 

JFSPRI, 3-96, 3-97, 3-215 
bit in KEY, 2-13 


3-215 


JFSYS, 3-96, 3-97, 3-215 
bit in KEY, 2-12 

JMPX, 3-7 

Job 


aborting, 5-5 

attaching to, 3-299 

context information, 2-13, 
3-215 

creating logged-in, 3-379, 
3-381 

creating logged-out, 3-377 


Job (Cont. ) 


definition, 2-9f 
detaching, 3-351 
general discussion, 1-6 
getting high limit, 7-41 
indication of login, 2-12 
killing, 3-308, 3-336 
new on system, 2-32 
parameters, 5-35, 5-39 
preallocate memory for, 2-24 
private maximum size, 5-29 
reattaching to, 3-301 
returning statistics on, 3-251 
returning status information on, 
3-462 
suspending with .SLEEP, 3-217 
suspending with .TWAIT, 7-74 
suspending with SPNDSS, 5-59 
suspending with UU.STL, 3-453 
swap console with, 3-302 
Swapping to disk, 2-12, 3-97, 
3-215 

timing information on, 3-254 

Job area, 1-2, 2-9£ 

Job context information, 2-13, 

3-204 

Job image 
changing size, 3-100, 7-38 
maximum size, 2-26 
minimum size, 2-25 

Job keyboard monitor, 2-31, 3-107, 

3-204, 3-205, 5-25, 7-36 

JOB MAX, 3-392 

Job space, 2-6 

Job-context information, 2-33 

JOBCNT, 3-470 

JOBTBL, 3-468 

JSBTBL, 3-468 

JSR PC, substitute for, 3-7 


Kernel mode 
Active Page Register (APR), 2-5, 
3-151 
Kernel mode vector 
B.10, 2-27 
B.250, 2-27 
B.4, 2-27 
Kernel mode vector 244, 2-29 
Kernel mode vector 34, 2-28 
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KEY, 2-30, 2-33 
clearing bits in, 3-96 
definition, 2-11 
low 512 bytes, 2-10f 
setting bits in JFLOCK, 3-215 
Keyboard 
disabling echo, 3-234 
enabling echo, 3-234 
forcing output, 3-237 
getting line from, 7-42 
ODT-mode input, 3-257 
reads, 3-189 
setting private delimiters for, 
3-239 
special functions, 3-237 
writing data, 3-497 
Keyboard monitor, 1-l, 2-6, 2-18, 
2-30, 3-261 
default, 2-31, 5-25, 7-36 
entry, 2-31 
job, 2-31, 3-107, 3-204, 5-25, 
7-36 
prompts, 2-32 
system default, 3-107 
Keyboard monitor wait, 2-32, 
3-192 
Keyword 
clearing bits in, 3-96 
setting bits, 3-214 
when refreshed, 2-12 
Killing a job, 3-308, 3-336 


-L- 
LB:, 3-263 
LBR, 1-3 
LIBR, 1-3 
Librarians, 1-3 
Library 


cluster, 1-4 
macro, 1-3 
object, 1-3 
resident, 1-4 
save image, l1- 
universal, 1-3 
Line 
getting from terminal, 7-42 
width, 3-186 
Line delimiters, 3-189 
Line printer 
MODE values, B-9 
"no stall" option, 3-500 


5 


Line printer (Cont.) 
RECORD values, B-10 
writing data, 3-497 

LINK, 1-3, 1-5, 3-8 

Linker, 1-3 
RT11, 2-10 

List 
logical names, 3-446 

Loader, 1-2 

Local data message 
receive, 3-141 
send, 3-135 

Locking disk blocks, 3-220 

Log, error, 2-24, 3-106 

Logged-in job 
create, 3-379, 3-381 


entry to keyboard monitor, 2-32 


Logged-out job 
create, 3-377 


entry to keyboard monitor, 2-32 


Logical names, 3-109, 3-123 
adding system-wide, 3-443 
assigning, 3-263 
deassigning, 3-274 
deassigning all, 3-270 
removing system-wide, 3-444 

Logical unit number 
assigning, 5-6 
getting information on, 5-31 

LOGIN, 1-6 

Login, indication of, 2-12 

Logins, 3-385 
disabling further, 3-405 
enabling, 3-484 
set number allowed, 3-392 

Logout, 3-306 
shutup, 3-353 

LOGOUT utility, 3-38 

-LOGS, 3-123 to 3-130 

LOGTBL offset, 6-16 

LOKFQ, 3-63 to 3-72 
disk directory lookup, 3-64 


disk wildcard directory lookup, 


3-68 

I/O support, 3-1l 
-LOOKUP, 7-46 
Lookup 

directory, 3-50, 3-355 

special magnetic tape, 3-52 
Low segment, 2-6, 2-9f 

first 512 bytes, 2-10, 2-10f 
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Low segment (Cont. ) 
first 512 bytes for RSX, 4-10, 
4-11t 
first 512 bytes for RT1l1l, 6-11 


-M- 


MAC assembler, 1-3, 4-1 
using general directives with, 
3-1 
MACRO assembler, 1-3, 6-1 
uSing general directives with, 
3-1 
Macro library, 1-3 
MAGLBL, 3-472 
Magnetic tape 
back spacing, 3-230 
CLUSTERSIZE values, B-7 
file characteristics word, 
3-233 
get directory for, 3-49 
MODE values, B-6, B-8 
reads, 3-189 
setting density, 3-230, B-8 
setting parity, 3-230, B-8 
skipping record, 3-230 
special directory lookup, 3-52, 
3-358, 3-359 
special functions for, 3-229 
status word, 3-232 
writing data, 3-497 
writing end-of-file, 3-230 
MAKSIL, 1-5 
MAPS, 5-43 
MAPFQ, 3-175 to 3-181 
Mapping, 2-2 
address windows, 5-43 
physical memory, 3-179 
RDMEM privilege, 3-179 
resident library, 3-160, 
SYSMOD privilege, 3-179 
Masks 
private delimiter, 3-242t 
MAXCNT, 3-468 
~MCALL, 4-2 
MEMLST, 3-468 
Memory 
changing allocation, 3-100 
changing size, 3-420 
expansion, 2-12 
increasing allocation, 5-29 
Mapping, 2-2, 2-5f 


3-175 


Memory (Cont. ) 
page, 2-1, 2-2 
poking, 3-416 
Memory management, 2-1 
T&D Space, 2-2 
MEMSIZ, 3-470 
-MESAG, 3-131 to 3-147 
-MESAG subfunction, send 
privileges, 3-143 
Message 
EMT logger, 3-142 
receive local data, 3-141 
send local data, 3-135 
send/receive, 3-131 
MFDPTR, 3-472 
Mnemonics, 3-8 
Mode 
ODT (one-character) input, 
3-257 
tape, 3-256 
MODE modifier, OPEN FOR INPUT, 
3-76 
MODE offset, 6-16 
MODE option, 3-31, 3-40 
disk, B-2 
flexible diskette, B-5 
line printer, B-9 
Magnetic tape, B-6, B-8 
pseudo keyboard, B-17 
terminal, B-1ll 
/MODE switch, 3-108, 7-12 
Monitor 
fixed locations for .PEEK, 
3-152t 
general RSTS/E directives, 1-5, 
3-1 to 3-502 
RSX emulation, 4-2 
tables, 3-467, 3-469, 3-471 
Multiple private delimiters, 
3-239 to 3-250 
Multiterminal service, 3-500 


-N- 


-NAME, 3-104, 3-148 to 3-150 

Name program, 3-148 

NOCTLC offset, 6-16 

Non-file-structured I/0 
RSTS/E monitor, 4-2 

NRRTS, 2-31 

NULRTS, 3-472 
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-O- 


Object library, 1-3 
Octal Debugging Tool 
see ODT 
ODT (Octal Debugging Tool), 2-21, 
2-25, 3-257, 5-60 
ODT mode, 3-237, 3-257 
ODT-mode input, 7-71 
Offline, taking magnetic tape, 
3-230 
ONLCLN, 3-402 
Open 
binary file, 
existing file, 
file, 3-29 
file or device, 3-73 
file-structured, 3-73 
non-file-structured, 3-73 
OPEN FOR INPUT, 3-73 


3-22 
3-73 


MODE modifier, 3-76 
OPEN FOR OUTPUT, 3-29, 3-31, 3-40 
Open next disk file, 3-406 
OPNFQ, 3-73 to 3-81 
OPSER-based 
spooling package, 3-449 


ORG, 3-4 
requirement for, 3-6 


=p. 


P.2CC, 2-19f 
definition, 2-30 
P.BAD, 2-19f 
definition for asynchronous 
exceptions, 2-30 
definition for synchronous 
exceptions, 2-26 
P.BPT, 2-19f 
definition, 2-27 
P.cC, 2-19f 
definition, 
P.CRAS, 2-19f 
P.DEXT, 2-19f, 3-431 
definition, 2-25 
P.EMT, 2-19f 
definition, 2-28 
P.FIS 
definition, 2-26 
P.FLAG, 2-19f, 2-23, 2-28, 6-4 
combinations, 2-25 
definition, 2-22 


2-29 


P.FPP, 2-19f£ 
definition, 
P.IOT, 2-19f 
definition, 2-28 


2-29 


P.MSIZ, 2-19f, 2-25, 3-100, 3-101, 
3-431 

P.NEW, 2-19f, 3-205, 3-206, 3-208, 
5-25 


definition, 2-31 
P.OFF, 2-19f 
definition, 2-21 
P.RUN, 2-19f 
-CCL passes control to, 
channel 17 open, 3-10 
definition, 2-34 
entry at, 2-12 
passing control, 3-210 
P.SIZE, 2-19f, 2-26, 3-100, 
P.STRT, 2-19f 
P.TRAP, 2-19f 
definition, 
Page, 2-1, 2-2 
Page Address Register 
See PAR 
Page Descriptor Register 
See PDR 
Paper tape punch, 
Paper tape reader 
reads, 3-189 
PAR (Page Address Register), 2-1, 
2-2 
Parameter word, 3-377, 3-379 
Parity, setting magnetic tape, 
3-230 
Password, changing, 3-336 
Password, set long, 3-336 
PAT (Patch Utility), 1-3 
object module, 1-3 
Patch Utility 
See PAT 
PBS (Print/Batch Services) 
spooling package, 3-449 
PC (Program Counter), 2-6 
PDR (Page Descriptor Register), 
2-1, 2-24 
-PEEK, 3-151 to 3-153 
fixed monitor locations, 3-152 
PF.1US 
bit within P.FLAG, 2-22f 
definition, 2-24 
PF.CSZ 
bit within P.FLAG, 2-22f 


3-90 


3-431 


2-28 


3-497 
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PF.CSZ (Cont. ) 
definition, 2-24 
PF.EMT, 2-28, 6-4 
bit within P.FLAG, 2-22f 
definition, 2-21, 2-22 
PF.KBM 
bit within P.FLAG, 2-22f 
definition, 2-24 
PF.NER, 2-24 
bit within P.FLAG, 2-22f 
PF.REM, 2-24 
bit within P.FLAG, 2-22f 
PF.RW, 2-24 
bit within P.FLAG, 2-22f 
Physical addressing, 2-1, 2-2 
Physical device name, 3-123 
Physical memory 
Mapping, 3-179 
»-PLAS, 3-154 to 3-185 
subfunction summary, 3-154 
-PLAS directive, 1-4 
»-PLAS subfunctions, 3-155t 
Poking memory, 3-416 
/POSITION switch, 3-108, 7-12 
POSITN offset, 6-16 
-POSTN, 3-186 to 3-187 
PPN (Project-Programmer Number ) 
assignable, 3-110 
entering user logical for, 
3-263 
file specification, 3-110 
offset, 6-16 
wildcard lookup, 3-418 
Preallocate memory, 2-24 
Prefix EMT, 1-5, 2-22, 2-28 
Primary run-time system, 1-1 
-PRINT, 7-48 
Print/Batch Services 
See PBS 
Priority, 2-13 
changing, 3-420 
run, 3-215 
Private delimiters 
and binary mode, 3-240 
characteristics, 3-240 
definition, 3-239 
keypad applications, 3-239 
masks, 3-242t 
system processing, 3-240 
Private memory maximum, 2-12 
Privilege 
permanent, 2-12, 3-97 


Privilege (Cont. ) 
temporary, 2-12, 3-97, 3-215 
Privilege checking 
third-party, 3-488 
Privilege mask 
checking, 3-328 
Privilege name 
checking, 3-328 
Privileges 
Clear current, 3-422 
read current, 3-422 
set current, 3-422 
Program 
maximum size under RSX, 5-29 
maximum size under RT1ll, 6-13 
running, 3-210 
suspending, 3-217, 5-59, 7-74 
Program Counter 
See PC 
Program name, 3-148 
returned by .DATE, 3-104 
Program Status Word 
See PSW 
Project-Programmer Number 
See PPN 
Prompts 
keyboard monitor, 2-32 
PROTEC offset, 6-16 
Protection code 
default, 2-18 
file specification, 3-112 
/PROTECTION switch, 3-109, 7-12 
-PSECT, requirement for, 3-6 
Pseudo keyboard 
errors on output request, B-18 
MODE values, B-17 
reads, 3-189 
RECORD values, B-18 
special functions for, 3-234 
state change, 3-217 
writing data, 3-497 
Pseudovectors, 2-9, 2-18 to 2-38 
format with high segment, 2-19 
PSW (Program Status Word), 2-6, 
6-5 
-PURGE, 7-49 


-Q- 


QIOS, 5-46 
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Quota 
changing, 3-336 
detached job, 3-308 
disk, 3-308 


-R- 


-RCTRLO, 7-50 
RDBBKS, 5-53 
RDBDFS, 5-53 
RDMEM privilege 
Mapping, 3-179 
-READ, 3-188 to 3-193 
RTl1, 7-51 
Read 
device, 3-189 
file, 3-189 
ODT-mode, 3-257, 7-71 
Read-only run-time system, 2-24 
Read/write run-time system, 2-24 
»-READC, 7-51 
-READW, 7-51 
Reattach to job, 3-301 
Receive, 3-140 
local data message, 3-141 
Receiver ID Block 
See RIB 
Record Management Services 
see RMS 
RECORD option, 3-191, 3-197, 
3-493, 3-499 
flexible diskette, B-5 
line printer, B-10 
pseudo keyboard, B-18 
terminal, B-12 
RECORDSIZE option, 3-76 
Remove receiver, 3-134 
.RENAME, 7-53 
Rename file, 3-82, 7-53 
RENFQ, 3-82 to 3-85 
-REOPEN, 7-55 
REORDR, 3-37, 3-42, 3-81 
Reset channel, 3-86 
Resident library, 1-4 
accessing, 3-154 
adding, 3-430, 3-434 
attaching to, 3-156, 5-10 
creating window, 3-160 
creating window to, 5-13 
detaching from, 3-167, 5-21 
eliminating window to, 3-171 
mapping windows to, 5-43 


Resident library (Cont. ) 
maximum number, 5-10 
Maximum number of, 3-156 
removing, 3-437 
special RSX directives, 5-53 
unloading, 3-438 
unmapping window from, 5-66 
RETURN macro, 3-7 
Rewind tape, 3-230 
RIB (Receiver ID Block), 3-132, 
3-133, 3-140, 3-143 
RMS (Record Management Services), 
4-2 
/RONLY switch, 7-12 
RSTFQ, 3-86 to 3-88 
RSX 
emulation in the monitor, 3-160, 
4-2 
environment, 4-1 to 4-12 
run-time system, 1-1, 1-2, 2-25, 
4-2 
RSX directives, 1-5 
SC form, 4-8, 4-9 
expansions, 4-2 t 
S$ form, 4-6, 4-7 
SS form, 4-9 
summary, 5-1t 
summary of, 5-1 
RSXMAC.SML, 4-2, 4-4 
RT11 
environment, 6-1 to 6-17 
low 512. bytes for, 6-11 
run-time system, 1-1, 2-25 
scratch pad area, 6-13 
use of special prefix EMT, 2-23 
RT11 directives, 1-5 
call formats, 6-7 
expansions, 6-4 
not processed on RSTS/E, 7-1 
summary of, 7-2 
RT11 run-time system 
illegal general monitor calls, 
3-1 
-RTS, 3-204 to 3-209, 3-384 
RTSLST, 3-470 
-RUN, 3-210 to 3-213, 3-384 
hard errors, 3-212 
soft errors, 3-212, 3-213 
-RUN directive, 2-25 
Run priority, 2-13, 3-215 
Run-burst, changing, 3-420 
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Run-time system, 2-9f 
adding, 3-430 
associating file with, 3-403 
capability defined, 2-21 
choosing, 1-2, 1-3 
default definitions, 2-2] 
exit processing, 3-204 


general discussion, 1-1 to 1-6 


modifying, 2-13 

name returned, 3-104 

passing control to, 3-204 

primary, 1-1 

removing, 3-431 

Space taken by, 2-6 

top address, 1-5 

unloading, 3-433 

when removed, 2-24 

writing or modifying, 1-5 
Running a program, 3-210 


-S- 


SATCTL, 3-468 
SATCTM, 3-468 
SATEND, 3-472 
Save Image Library 
see SIL 
.SAVESTATUS, 7-57 
-SCCA, 7-59 
SCCASS, 5-55 
Scratch pad, 6-13, 7-63 
getting value from, 7-44 
Seize operation, 3-265 
Send local data message, 3-135 
Send privileges, .MESAG 
subfunction, 3-143 
-SET, 3-214 


Set device characteristics, 3-312 


.SET directive, 2-ll 


SET JOB/KEYBOARD_MONITOR command, 


3-204, 7-36 

Set system default 
characteristics, 3-312 

Set terminal characteristics, 
3-474 

»~SETCC, 7-61 

»SETFQB, 7-62 

»SETTOP, 7-63 

.SFPA, 7-64 

SFPAS, 5-57 

SHOW DISK command, 3-402 


SHOW RUNTIME_SYSTEM command, 2-25 


Shut down system, 3-353 
Shutup logout, 3-353 
Significant event flag, 5-70 
SIL (Save Image Library), 1-5 
SILUS, 1-5 
Single event flag, 5-71 
Single-job monitor, 6-1 
/SIZE switch, 3-108, 7-12 
CCL command, 3-91 
-SLEEP, 3-217 to 3-218 
conditional, 3-217, 3-218 
Small buffers, 2-6 
Snap shot dump, 3-363, 3-415 
SNDLST, 3-470 
SP (Stack Pointer), 2-13, 2-27, 
2-28, 2-30, 2-33 
-SPEC, 3-219 to 3-236 
disk, 3-220 
flexible diskette, 3-223 
magnetic tape, 3-229 
pseudo keyboard, 3-234 
terminal, 3-237 
Special prefix EMT, 1-5, 2-23, 
2-28, 6-4 
-SPFUN, 7-66 
SPNDSS, 5-59 
Spooling, 3-449 
Spooling package 
OPSER-based, 3-449 
PBS (Print/Batch Services), 
3-449 
-SRESET, 7-68 
SST (Synchronous System Traps), 
2-18 
Stack overflow, 2-13, 2-30 
Stack Pointer 
See SP . 
Stack Pointer Register 
See SP 
Stall system, 3-453 
-STAT, 3-251 to 3-253 
Statistics 
changing file, 3-304 
returning for job, 3-251 
Status byte, 3-369 


STATUS variable, 2-35, 3-34, 3-42, 


3-118 


Status word, magnetic tape, 3-232 


Status, exit with, 5-27 
String 
display at terminal, 7-48 
scan for file name, 7-28 
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Suspend 
job (with .SLEEP), 
job (with .TWAIT), 7-74 
job (with SPNDSS), 5-59 
jobs on system (with UU.STL), 


3-217 


3-453 

SVDBS, 5-60 
SVTKS, 5-63 
Swap console function, 3-302 
Swap file, 3-457, 3-459 
SWAP MAX, 3-421, 5-29 
Swapping, 2-12, 3-97, 3-215 
Symbol table file 

ERR.STB, 3-8 
Synchronous exception, 2-26, 5-60, 

5-63 

Synchronous System Traps 

See SST 
SSYSMAC.SML 

system macro library, 6-3 


SYSMOD privilege 
Mapping, 3-179 
SYSTAT, 3-148 
System default run-time system. 
See Default keyboard monitor 
System error log, 2-24 
System macro library, 
SSYSMAC.SML, 6-3 
System-wide logical names 
adding, 3-443 
removing, 3-444 


4-2 


-T- 


Tape 
See Magnetic Tape or DECtape 
Tape mode, 3-237, 3-256 
Task 
exit, 5-25 
Task Builder 
See TKB 
Temporary file, 3-38 
Temporary privilege, 
Tentative file, 3-86 
Terminal 
disabling, 3-336 
disabling echo, 3-234 
enabling echo, 3-234 
escape sequences mode, 
forcing output, 3-237 
getting line from, 7-42 
MODE values, B-1l1l 


3-215 


3-241 


Terminal (Cont. ) 
"no stall" option, 3-500 
ODT-mode input, 3-257 
reading low-speed tape on, 
3-256 
reads, 3-189 
RECORD values, B-12 
setting characteristics, 3-474 
setting private delimiters for, 
3-239 
special functions, 3-237 
TTSYNC characteristic, 3-241 
writing data, 3-497 
-TIME, 3-254 to 3-255 
Time 
changing system, 
conversion, 3-344 
current, 5-37 
returning under RTll, 
7-40 
slice, 2-5 
Timing, returning for job, 
TITLE, 3-4 
TKB (Task Builder), 
4-1, 4-4, 4-10 
TMPORG, 3-5 
Transfer request block, 
Transportable code 
RSX-11M-PLUS, 4-1 
RT1l1, 6-1 
VAX/VMS under AME, 
Trap, 2-18 
asynchronous CTRL/C, 
emulator, 2-21 
kernel mode address 10, 
kernel mode address 4, 
TRAP instruction, 2-28 
-TRPSET, 7-69 
-TTAPE, 3-256 
undoing, 3-259 
-TTDDT, 3-257 to 3-258 
-TTECH, 3-259 
~-TTINR, 7-71 
-TTNCH, 3-260 
undoing, 3-259 
-TTOUTR, 7-73 
-TTRST, 3-261 
TTSYNC characteristic, 
TTYHCT, 3-470 
~-TTYIN, 7-71 
-TTYOUT, 7-73 
-TWAIT, 7-74 


3-347 


7-23, 


3-254 


Le3 7 125, 326, 


2-14 


4-1 


5-55 


7-69 
7-69 


3-241 
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Type -ahead 
canceling, 3-237 
-U- 


UCTTBL, 3-472 
UFD (User File Directory), 
deleting, 3-487 
positioning on disk, 
preextending, 3-411, 
-ULOG, 3-262 to 3-278 
subfunction summary, 
-ULOG directive, 2-18 
UMAPS, 5-66 
UMPFQ, 3-182 to 3-185 
Universal library, 1-3 
Unmapping address window, 
5-66 
UNORG, 3-5 
Unstall systen, 
UNTCLU, 3-468 
UNTCNT, 3-468 
UNTERR, 3-472 
UNTLVL, 3-472 
UNTOPT,. 3-468 
User File Directory 
See UFD 
User job area, 
User job image, 
changing size, 
definition, 2-6 
expanding, 5-29 
maximum size, 2-26 
minimum size, 2-25 
preallocate memory for, 
User logical, 3-113 
deassigning, 3-262, 3-274 
deassigning all, 3-270 
destroyed, 2-30 
entering, 3-262 
User mode 
Active Page Register (APR), 2-5 
User stack area, 2-13 
USRLOG, 3-113, 3-264 
-FSS causes check of, 3-109 
within low 512 bytes, 2-11f 
USRPPN, 3-110, 3-113, 3-264 
within low 512 bytes, 2-11f 
USRPRT, 3-113, 3-264 
within low 512 bytes, 
USRSP, 2-30 — 
definition, 


3-32 


3-412 
3-414 


3-262 


3-182, 


3-453 


1-2, 
2-9£ 
3-100 


2-9f 


2-24 


2-l1llf 


2-13 


‘UU.FIL, 


USRSP (Cont. ) 

low 512 bytes, 
USTAT byte, 3-357 
UU.3PP, 3-488 
UU.ACT, 3-284 
UU.ASS, 3-263 to 3-269, 
UU.ATR, 3-288 
UU.ATT, 3-299 
UU.BCK, 3-304 
UU.BYE, 3-306 
UU.CCL, 3-310 
UU.CFG, 3-312 
UU.CHE, 3-325 
UU.CHK, 3-328 
UU.CHU, 3-336 
UU.CNV, 3-344 
UU.DAL, 3-270 to 3-273, 
UU.DAT, 3-347 
UU.DEA, 3-274 to 3-278, 
UU.DET, 3-351 
UU.DIE, 3-353 
UU.DIR, 3-355 
UU.DLU, 3-361 
UU.DMP, 3-363 
UU.ERR, 2-27, 
UU.FCB, 3-367 
3-371 
3-375 
3-377 to 3-384 
3-384, 3-385 
3-392 
3-394 
3-399 
3-403 
3-405 
3-406 
3-411 
3-416 
3-418 
3-420 
3-422 
3-425 
3-430 to 3-442 
3-443 
3-449 
3-453 
3-455 
3-462 
3-467 
3-469 
3-471 
3-474 


2-10£ 


3-286 


3-346 


3-349 


2-30, 3-365 


UU.HNG, 
UU.JOB, 
UU.LIN, 
UU.LOG, 
UU.LOK, 
UU.MNT, 
UU.NAM, 
UU.NLG, 
UU.ONX, 
UU.PAS, 
UU.POK, 
UU.PPN, 
UU.PRI, 
UU.PRV, 
UU.RAD, 
UU.RTS, 
UU.SLN, 
UU.SPL, 
UU.STL, 
UU.SWP, 
UU.SYS, 
UU.TB1, 
UU.TB2, 
UU.TB3, 
UU.TRM, 
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UU.YLG, 3-484 
UU.ZER, 3-486 


.UUO, 3-279 to 3-489 
subfunction summary, 3-279t 
UUOFQ, 3-89 


-V- 


ie Vi sawp TTB 

.-V2.., 7-78 ; 

Version 1 RT1ll, 7-78 

Version 2 RTll, 7-78 

Vertical format, control 
characters, 5-49t 

Virtual addressing, 2-1, 2-2 


-W- 


-WAIT, 7-75 

WCB (Window Control Block), 3-367 

WDB (Window Definition Block), 

5-68 

WDBBKS, 5-68 

WDBDFS, 5-68 

Wildcard 
account read and reset, 
file lookup, 3-63, 3-396 
PPN (Project-Programmer Number) 

lookup, 3-418 

Window 
creating, 5-13 
eliminating, 3-171, 
mapping, 3-175 
mapping to, 5-43 
maximum number of, 3-161 
resident library, 3-160 
unmapping from, 3-182, 

Window Control Block 
See WCB 


3-425 


5-23 


5-66 


Window Definition Block 
See WDB 
Window ID 
returned by CRAFQ, 3-164 
returned by CRAWS, 5-16 
used by ELAFQ, 3-171 
used by ELAWS, 5-24 
used by MAPFQ, 3-176, 3-180 
used by UMAPS, 5-67 
used by UMPFQ, 3-182, 3-183 
-WRITA, 3-490 to 3-496 
-WRITC, 7-76 


-WRITE, 3-497 to 3-502 
RT1l1, 7-76 
Writing, 3-490, 3-497 


one character, 7-73 
-WRITW, 7-76 
WSIGS, 5-70 
WTSES, 5-71 


-X- 


XBUF (Extended Buffer Pool), 2-5f 
XRB, 2-14 
clearing under RTll, 7-11 
data returned to, 3-10 
low 512 bytes, 2-10f 
mnemonics assigned to, 2-16 
P.NEW entry, 2-33 
P.RUN entry, 2-34 
presetting to zero, 3- 
routine to clear, 3-9 
size of, 2-16 
XRB format, 2-16f 
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-Z- 


zero device, 3-486 
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L} Assembly language programmer 

[]  Higher-level language programmer 
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[1 User with little programming experience 
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